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PREFACE 


MANUAL OBJECTIVES AND READER ASSUMPTIONS 

This manual is intended for the experienced system programmer; one 
who is familiar with RSX-11M operation and has an acquaintance with 
the RSX-1l1M Executive code. The Manual presents information 
tutorially. However, the manual also contains a great deal of 
cress-reference information for very experienced programmers who may 
not need the tutorial information. 


The System Logic Manual primarily discusses the Executive. However, 
cross-references for MCR and File Control Processor are also included. 


PREREQUISITE MANUALS 


The reader and user of this manual is expected to have read and 
understood the contents of the following manuals: 


Introduction to RSX-11M 

IAS/RSX-11 MACRO-11 Reference Manual 
RSX-11M Executive Reference Manual 
RSX-11M Task Builder Reference Manual 
RSX-11M Guide to Writing an I/O Driver 
RSX-11M Operator's Procedures Manual 


RSX-11M System Generation Manual 


THE STRUCTURE OF THE LOGIC MANUAL 
VOLUME 1 


Chapter 1 - Introduction 
Chapter 1 presents a general description of the RSX-11M V3.1 
system for those who may need a fundamental introduction. This 
chapter expands much of the material found in Introduction to 
RSX-11M. 


xvil 


Chapter 2 - Memory Resource Allocation 
Chapter 2 describes Memory Management and the important routines 
that allocate memory resources. Specifically, Chapter 2 
describes the Loader, the Shuffler, SNXTSK, SCHKPT, and 
associated routines. 


Chapter 3 - Interrupt Processing 
Chapter 3 describes Executive interrupt and fork processing. The 
important interrupt routines are described. A figure along with 
supporting text describes the code path followed by the interrupt 
and fork routines that a sample driver uses. 


Chapter 4 - Privileged Tasks 
Chapter 4 describes the purpose of privileged tasks, their use 
and the cautions concerning their use, the use of $SWSTK (switch 
stack), and mapping for both privileged and nonprivileged tasks. 


Chapter 5 - MCR Interface 
Chapter 5 describes the function of the MCR interface, the MCR 
Dispatcher, and how MCR processes a command line entered at a 
terminal. 


Chapter 6 - I/O Processing 
Chapter 6 discusses the internal processing of the QIO directive. 


Chapter 7 - Module Descriptions 
Chapter 7 contains brief descriptions of the modules that make up 
the Executive. Entry points, inputs, outputs, and exit status of 
the modules are also described. 
Chapter 8 - Data Areas and Control Blocks 
Chapter 8 contains figures that show various system linkages ina 
generalized form. Important functions of the Device Control 
Block, Unit Control Block, and Status Control Block are also 
discussed. Also shown are all the bit definitions for the system 
control blocks. 
Chapter 9 - Cross-references 
Chapter 9 contains important cross-references, created by the 
CREF program, that you can use to find your way through the 
system listings. The references include: 
For the Executive: 
@e Module-to-routine cross-references 
e Symbol-to-module cross-references 
For MCRMU (multiuser MCR): 


e Symbol-to-module cross-references (created by the 
CREF program) 


e MCRMU segment cross-references 
e SYS symbol-to~module cross-references 


e SYS segment cross-references 
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For the File Control Processor (BIGFCP): 
@e Symbol-to-module cross-references 
e BIGFCP segment cross-reference 


Chapter 9 also contains cross-references between Executive 
modules and conditional assembly parameters that these modules 
contain. 


VOLUME 2 


Appendix A - RSX-11M Supported Devices 
Appendix A contains a list of devices supported by RSX-11M V3.1. 


Appendix B - Coding Standards and Conventions 
Appendix B contains an explanation of the coding standards and 
conventions that RSX-11M follows. Appendix B also describes the 
Executive's use of co-routines by explaining an example 
co-routine from Executive code. 


Appendix C - Macro Expansions 
Appendix C contains the expansions of all the macros used in the 
system code. 


Appendix D - Listing of Conditional Assembly Parameters ~ 
Appendix D lists all the conditional assembly parameters and 
their meanings. 


Appendix E - General Fault Isolation 
Appendix E contains a generalized approach to program fault 
isolation for RSX-11M. 


Appendix F - System Tuning 


Appendix F contains many ideas that can help you to improve 
system performance. 
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CHAPTER 1 


INTRODUCTION TO THE RSX-11M V3.1 OPERATING SYSTEM EXECUTIVE 


This introduction is a tutorial for those who are beginning to learn 
the RSX-11M Executive internal logic, However, this manual assumes 
that you have at least read and understood the RSX-11M_ Introduction, 
the RSX-11M Operator's Procedures Manual, the RSX-11M Task Builder 
Reference Manual, and the RSX-11M System Generation Manual. If you 
are familiar with the RSX-11M Executive or you are an experienced 
system programmer, you may want to begin this manual with Chapter 2, 
which assumes that you have a basic knowledge of the Executive and 
describes the memory structures of RSX-11M. 


1.1 RSX-~-11M SYSTEM 


RSX-11M is a real-time operating system. This means that RSX-11M 
responds guickly to input conditions or input data. RSX-11M is also a 
multiprogramming system. This combination allows real-time activity 
(for example, process control) to occur along with program development 
(interactive terminals) and other user jobs. At one extreme, RSX-11M 
can be a dedicated process control system, and at the other, a system 
for developing and running applications programs. 


1.2 SYSTEM GENERATION 


RSX-11M offers a wide range of services and utilities from which to 
choose. Each installation selects from these options to shape its 
version of RSX-11M according to the processor and peripherals 
available and the purpose of the system. You perform a system 
generation (SYSGEN) process to select these options. 


Every installation intitially receives an RSX-11M system on 
distribution media. You run this system and use its resources to 
generate a target system configured to your installation's needs. 


System generation is done in two phases. During the first phase 
SYSGEN defines and assembles the Executive (the kernel or "brain" of 
the operating system that responds to external requests) by conducting 
a dialogue with you. Query programs pose questions at a terminal. 
Your answers to the questions determine the Executive service options, 
processor options, and peripheral devices to be incorporated into the 
system. During the second phase, SYSGEN builds the Executive, allows 
you to define memory structures called partitions, and builds and 
installs the system programs. 


You complete the SYSGEN process by saving and bootstrapping the new 
system. Saving a system means writing the image of an RSX-11M system 
that has been resident in main memory into the system image file from 
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which it was bootstrapped. You do this with the Save command, which 
saves the image to allow a hardware bootstrap or the Boot command to 
later reload and restart the system. 


You bootstrap (boot) a system by either using the switches on the 
processor control panel or using the Boot command. The Boot command 
bootstraps a system that exists as a system image file on a Files-11 
(the RSX-11M file structure) volume. The Boot command immediately 
terminates the system in operation and starts another. The Save 
command, the Boot command, and the process of booting a system with 
the switches are all described in the RSX-11M_ Operator's Procedures 
Manual. . 


To change either the hardware or software configuration of an 
installation, you must perform another system generation. The RSX-11M 


System Generation Manual describes the system generation process in 
detail. 


1.3 MAJOR COMPONENTS OF RSX-11M 


RSX-11M requires the organized interaction of the following 
components: 


@ Memory resource management. Memory is the processor storage 
medium in which loaded user programs, the Executive , and 
control blocks of data reside. Much of the Executive's work 
involves memory resource management and control. 


e Task scheduling and processing. Tasks are system or user 
programs that perform needed functions and manipulate data to 
achieve some goal. The Executive controls task processing and 
handles specific requests issued by the tasks. 

e Interrupt processing. The Executive processes synchronous and 
asynchronous events that occur as a result of task processing. 


Examples of these events include software errors, I/O 
completion, illegal instructions, and power failure. 


1.4 MEMORY 


1.4.1 Memory Partitions 
A partition is a continuous area of memory in which executable 
programs called tasks can be run. The typical memory organization 
consists of an area for the Executive and areas for system- or user- 
controlled partitions. A partition has the following characteristics: 
e@ A name 
e A defined size 
e A fixed base address 


e A defined type 


INTRODUCTION TO THE RSX~-11M V3.1 OPERATING SYSTEM EXECUTIVE 


1.4.2 Partitions In Mapped And Unmapped Systems 


RSX-11M runs on almost all models of the PDP-11l processor. The PDP-1l 
addressing scheme allows a program to address directly only 32K words 
of memory. For larger memories, DIGITAL has a KT-11 Memory Management 
Unit (hardware) available for all models of the PDP-11 except the 
PDP-11/03/04/05/10/20 processors. The KT11 Memory Management Unit 
associates addresses expressed in programs ("virtual" addresses in the 
range 0 to 32K) with actual locations in memory ("physical" 
addresses). Physical addresses can range from 0 to 124K words on all 
processors other than the PDP-11/70. Physical addresses on a 
PDP-11/70 can range from 0 to 1920K words. 


Mapping is the process that associates virtual addresses with physical 
addresses, Therefore, a PDP-1ll system that includes a KT11 Memory 
Management Unit is called a mapped system. Conversely, systems 
without a kKT11l are called unmapped systems. In a mapped system, a 
task can be installed in any system partition or user partition large 
enough to contain it. In an unmapped system, the task is bound to 
physical memory and must be installed in the partition that starts at 
the same memory address as the partition for which it was built. 


Whether a system is mapped or unmapped affects the way in which you 
create tasks. Before a compiled program (object code) can be run, it 
must be processed by the Task Builder program (linker). The Task 
Builder produces a task image that runs in a memory partition. 


If a system is unmapped, you must specify to the Task Builder the base 
address of the partition in which the task is to be run. You cannot 
run the resulting task in a partition that has a base address 
different from the address you specified to the Task Builder. 


In a mapped system, however, every task (other than a privileged task 
mapped into the Executive) has a virtual base address of 0. 
Transparently to the user, the KT1l maps the virtual addresses of a 
task to the actual physical addresses in which the task resides. A 
task in a mapped system can therefore run in any partition large 
enough to contain it. 


You need not rebuild nonprivileged tasks in a mapped system when 
physical partition boundaries move. This is true because 
nonprivileged, tasks on a mapped system run at a virtual base address 
of 0, rather than at a physical base address. ; 
If you move the symbols that are referenced in the code, you must 
rebuild privileged tasks in either system because they are linked to 
the Executive symbol table file. You may be required to rebuild 
nonprivileged tasks only if you change any of the task's attributes 
such as checkpointability. The task's attributes can be changed when 
you use the Install command to install the task. You use the Task 
Builder to establish the attributes when building a task. Consult the 
RSX-1IM Task Builder Reference Manual for a comprehensive discussion 
of task attributes and associated Task Builder switches. See the 


RSX-11M Operator's Procedures Manual for a description of the Install 
command. . 


1.4.3 Partition Types 
RSX-11M supports two types of partitions in which tasks can execute: 
1. System-controlled 


2. User-controlled 
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In a system-controlled partition, the Executive allocates available 
Space to accomodate as many tasks as possible at any one time. This 
allocation may involve shuffling resident tasks to arrange available 
space into a continuous’ block large enough to contain a reguested 
task. The Shuffler, which is a privileged task and a SYSGEN option, 
shuffles the tasks and memory space to make the needed space for the 
reguested task. Only mapped systems support system-controlled 
partitions. 


A user-controlled partition is exclusively allocated to one task at a 
time. Both mapped and unmapped systems support this type of 
partition. 


1.4.4 Subpartitions 


You can subdivide a user-controlled partition into as many as seven 
nonoverlapping subpartitions. Like its parent main partition, a 
subpartition can contain only one task at ae time. Because the 
subpartitions occupy the same physical memory as the main partition, 
tasks cannot be simultaneously resident in both the main partition and 
one of its subpartitions. However, because each subpartition can 
contain a task, up to seven tasks can potentially run in parallel 
within a main partition. 


The purpose of subpartitioning is to reclaim large memory areas’ in 
unmapped systems. For example, when a large task that requires a main 
partition is either no longer active or can be checkpointed (written 
out to a disk to make room for a higher priority task), 
subpartitioning allows a number of smaller tasks to use the partition 
space. 


1.4.5 Memory Structure 


RSX-11M memory in a typical system can be divided into the following 
parts: 


e The Executive, which consists of: 


- Trap vectors. The trap vector area contains the hardware 
and interrupt vectors; it reguires 128 words. During 
SYSGEN, you can expand this area to 256 words. 


- System stack. The system stack area is an internal storage 
area for Executive use. The Executive uses it for nesting 
interrupts, saving registers and data, and internal calls. 
The stack reguires 60 to 110 words depending upon options 
selected at system generation time. 


~ System common data. This area contains system pointers that 
are filled in during system generation and used by the 
Executive and privileged tasks during execution. 


- The Executive code. The Executive coordinates and manages 
system resources and processes specialized system functions. 
System generation options determine the size and abilities 
of the Executive, 
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~ Dynamic Storage Region (DSR). The Executive continually 
uses temporary storage in memory. The Executive acquires, 
uses, and then returns the memory that it used to the 
available memory pool. If a given Executive service routine 
requests dynamic storage and it is unavailable, the 
Executive informs the user task, which usually waits for 
some memory to become available. The size of this region is 
important. If it is too small, long waiting periods or 
system deadlocks can occur. If it is too large, fewer tasks 
can fit into the remaining memory. The size of the region 
is a system generation parameter. 


You can extend the initial allocation of dynamic storage on 
line by issuing the MCR command, Set /Pool, from the 
console. However, the use of this command is limited in 
that this expansion can occur only into space that is not 
being used. This space, if it exists, is between the 
Dynamic Storage Region space and the first partition of 
memory. 


Device drivers: 


You can include three drivers in the 8K Executive during 
SYSGEN: , . 


1. A disk driver ed 


2. A cassette, DECtape, magtape, line printer, or floppy disk 
driver 


3. A terminal driver 


In general, Executives larger than 8K contain additional 
resident drivers which you include during system generation. 
Some drivers can be made loadable; that is, they reside on 
disk and are loaded into memory when they are needed. 
Therefore, loadable drivers save memory space because they 
occupy memory only when needed and they do not occupy 
Executive virtual address space. 


Loaders: 


The Loader is a task that runs in its own partition, which is 
resident in the Executive. Thus, it can run in parallel with 
system and user tasks. The Loader, which is device 
independent: 


1. Loads tasks upon initial load requests 


2. Writes checkpointable tasks to disk when reouired (see 
checkpointing, in this chapter) 


3. Reloads previously checkpointed tasks when memory becomes 
available, allowing them to actively compete for processor 
resources. 


MCR and TKTN tasks: 


~ The Monitor Console Routine (MCR) processes system commands 
that you enter at a terminal. These commands are directed 
to the MCR processor. MCR either executes the commands 
itself, or activates a system or user-written task that can 
service the commands. 
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- The Task Termination Notification Task (TKTN) performs two 
functions: 


l. It prints out messages and tries to print the contents 
of the registers of a task that has been aborted due to 
an error. 


2. It prints out messages for device drivers. 


Ideally, TKTN runs either in a partition in which all tasks 
are checkpointable or execute guickly, or in its own 
partition. The reason for this is that TKTN must be in 
Memory in order to print messages. If TKTN cannot get 
memory space to execute, the Executive queues up messages to 
TKTN, thereby using up Dynamic Storage Region space. It is 
conceivable that all the Dynamic Storage Region could be 
used up for this purpose; this would cause the system to 
hang up. 


The file system: 


Files-1l is a system of formatting files that are held on 
volumes. Files-1l volumes are magnetic media (tapes or disks) 
that have been specially formatted by the MCR command, 
Initialize Volume. Volumes that are not properly formatted 
are considered to be "foreign." RSX-11M includes ae file 
exchange utility that translates files in DIGITAL's DOS or 
RT-11 format into Files-1ll format. 


Your tasks that run on RSX-11M access data within files on 
Files~1l volumes through the use of two sets of subroutines: 


@ File Control Services (FCS) 
@ Record Management Services (RMS) 


Both FCS and RMS provide the ability for your tasks to perform 
record- or block-I/0 operations on Files-1ll volumes. FCS and 
RMS are system interfaces between the I/O programs that you 
write and the files on the Files-11 volumes that you want to 
access. These interfaces provide device independence and 
allow you to take advantage of different methods of file 
organization. 


FCS imposes a single logical organization on your files. This 
logical organization is called the sequential file 
Organization and FCS imposes it on all files regardless of 
medium, 


In contrast to FCS, RMS provides three file organizations - 
sequential, relative, and indexed. 


The MACRO-11 I/O programming that you do differs between FCS 
or RMS. Therefore, you must become familiar with the contents 
of the manuals that describe each one. The respective manuals 
are: 


For FCS: 


e IAS/RSX-11 1/0 Operations Reference Manual 
@ RSX-11M I/O Drivers Reference Manual 
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For RMS: 


® Introduction to RMS-1l 


@ IAS/RSX-11M RMS-11 MACRO Programmer's Reference Manual 


The Files-11 Ancillary Control Processor (FL1ACP) is a group 
of Executive subroutines that process and control the I/0 
control structures and devices for RMS or FCS. The Executive, 
FCS, and RMS use FILI1ACP; however, its operation is 
transparent to you. 


FIIACP is available in three versions. The first and smallest 
(FCPNMH.TSK) reguires 2K of memory. FCPNMH does not support 
mMulti-header files or RMS record blocking. The second 
(FCP .TSK) requires 2.5K of memory. The third version 
(BIGFCP.TSK) reguires from 4.5K to 8K of memory. You select 
these versions during SYSGEN. The RSX-11M System Generation 
Manual fully describes these versions, the reasons for their 
use, and the methods of installation. 


@ The print spooler: 


The print spooler task (PRT) speeds up the operation of 
MACRO-11, the Task Builder, and compilers because they do not 
have to wait for I/O to complete on the relatively slow line 
printer. Instead, the listing files are written to a disk. 
Subseguently, PRT prints the files as they appear in a gueue. 


Any task that uses the line printer to print files may use the 
print spooler. For example, the RSX-11M Peripheral 
Interchange Program (PIP) can optionally use the PRT task to 
print files. 


@e User task partitions 


User tasks run in the remaining memory in the memory 
structure, The partitions and tasks can be configured to the 
system user's requirements. 


1.4.6 Example Of A 16K Unmapped System 


Figure 1-1 illustrates the memory layout of a sample 16K unmapped 
system. The Executive region, which requires 8K, consists of the 
Executive and the user-controlled main partition named SYSPAR. This 
partition contains the file system (FCPNMH), the Monitor Console 
Routine (MCR), and the Task Termination Notification routine (TKTN). 
The file system is checkpointable and has a lower priority than MCR or 
TKTN. Therefore, if the file system is running and a system user 
reguests MCR, the Executive checkpoints the file system and loads and 
starts MCR. 
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WORDS BYTES 
’ 100000(8) 


PARSK -- USER-CONTROLLED 
MAIN PARTITION WITH 3 
SUB-PARTITIONS 


40000(8) 


USER-CONTROLLED PARTITION: 

FCPNMH — FILE SYSTEM 

MCR — MONITOR CONSOLE ROUTINE 

TKTN — TASK TERMINATION NOTIFICATION ROUTINE 


SYSPAR 


30100(8) 
OSR DYNAMIC STORAGE REGION 


DSKPAR SYSTEM DISK DRIVER 


SECPAR LINE PRINTER AND DEVICE DRIVERS 


SYSTEM TABLES (SYSTB) 
EXECUTIVE CODE 

TASK LOADER 

SYSTEM COMMON DATA 
SYSTEM STACK 

TRAP VECTORS 


EXECUTIVE 


Figure 1-1 Sample Unmapped 16K System Memory Layout 
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The user area contains a user~controlled main partition named PAR8K, 
8K in length. PAR8K contains three subpartitions, named SUBA, SUBB, 
and SUBC. Language processors and the Task Builder use the 8K 
partition for program preparation. These programs usually have a low 
priority and may be checkpointable. , 


The three subpartitions are available for real-time tasks. A task in 
the main partition is checkpointed if: 


e It is checkpointable 


@ Another higher priority task needs the partition, or a 
subparition 


If tasks occupy the partitions SUBA, SUBB, SUBC, and SYSPAR and the 
tasks are ready to run, the Executive gives CPU resources to the task 
with highest priority. 


1.4.7 Example Of A Mapped 124K-word RSX-11M System 
Figure 1-2 is an example of a large mapped system. 


Besides the Executive, the system contains DRVPAR, which is a 
system-controlled partition for loadable device drivers including the 
terminal driver. Loadable drivers residing on a disk are loaded by a 
user command when they are needed. 


SYSPAR is a 2K user-controlled partition that contains the Monitor 
Console Routine Multi-user (MCRMU) task, TKTN, and the Shuffler task. 
The Shuffler is discussed later in this chapter. 


FCPPAR is a 6K partition for the primary file control system, BIGFCP. 
The 6K size is sufficient to allocate approximately 50 file control 
blocks (FCBs). 


All other tasks run in the system-controlled GEN partition. 
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WORDS BYTES 
124K 400000(8) 
SYSTEM CONTROLLED 
GENERAL PARTITION USER TASKS 
(GEN) 
92K 200000(8) 
FILE SYSTEM PARTITION — 
PAR 
Pore BIG FILE SYSTEM (BIGFCP) 
26K 160000(8) 
ene LOADABLE DRIVERS 
se 13000018) EXECUTIVE PARTITION AREA — 
SYSPAR MCRMU, TKTN, AND SHUFFLER 
DYNAMIC STORAGE REGION 
20K Tone (TYPICALLY 4K — 6K) 
TASK LOADER 
SYSTEM TABLES 
EXECUTIVE CODE 
SYSTEM COMMON DATA 
SYSTEM STACK 
TRAP VECTORS 
0 0 


Figure 1-2 Example of a Mapped 124K RSX-11M System 
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1.5 TASK PROCESSING 


To make a task known to the Executive, you install it. When you 
install a task (by issuing the Install command; see the RSX-11M 
Operator's Procedures Manual), the system records a number of task 
parameters in a system-resident table called the System Task Directory 
(STD). The recorded parameters include the name and size of the task, 
the disk address at which the task's image starts, and the address of 
the Partition Control Block (PCB) of the partition in which the task 
is to run. 


1.5.1 Task States 


An installed task is defined as a task that has an entry in the STD. 
It is neither resident in memory nor competing for system resources. 
The Executive considers it to be dormant until a running task or a 
command issued from a terminal reguests the Executive to activate it. 
The Executive therefore recognizes two task states: 


e Dormant. A dormant task is one that has been installed (has 
an entry in the STD), but has not been requested to run. 


e Active. An active task is an installed task that has been 
reguested to run. It remains active until it exits, or gets 
aborted. It then returns to the dormant state. 


An active task can be in one of two substates, ready-to-run or 
blocked. 


1. Ready-to-run. A ready-to-run task competes with other 
tasks for CPU time on the basis of priority. The 
ready-to-run task having the highest priority obtains CPU 
time and thus becomes the current task. 


2. Blocked. A blocked task is unable to compete for CPU time 
for synchronization reasons or because a needed resource 
is not available. 


The distinction between dormant tasks and active tasks is important in 
a real-time system. A dormant task uses little memory; and yet when 
the task is needed to service a real-time event, the Executive can 
guickly and efficiently introduce it into active competition for 
System resources. An installed task's STD entry enables this quick 
response because it contains all the parameters the system needs to 
retrieve the requested task. Note that the number of installed, 
dormant tasks can, and usually will, far exceed the number of active 
tasks. 


When the Executive receives a request to activate a dormant 
nonresident task, it performs a series of actions: 


e It allocates the required memory resources on the basis of the 
task's priority. 


e It brings the task into memory. 


@e It places the task in active competition for system resources 
with other resident tasks. 


If tasks fully occupy the partition in which a task is installed and 
no resident task can be checkpointed (see Checkpointing in this 
chapter), the task is placed in a queue by priority with other 
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activated tasks, each waiting for space to become available in its 
partition. 


1.5.2 Fixed Tasks 


A task can be loaded and locked into its partition. Such a task is 
called a fixed task. The Fix command (see the RSX-11M Operator's 
Procedures Manual) allows you to fix a task in memory. The Executive 
services subsequent requests to run the task more guickly because the 
task is resident in memory and does not have to be loaded from the 
disk before it can run. The system can fix a task in memory only when 
the partition in which it is to be fixed becomes available. 


Fixed tasks remain physically in memory even after they finish 
execution. Therefore, the Executive does not have to reload them when 
they are again requested to run. However, tasks that can be fixed in 
memory must have re-entrant code if it is to be reused by another 
program or system user. Re-entrant code must be used because the task 
cannot be allowed to change its own internal data base if another 
program uses it. Only an Unfix or Remove command can free the memory 
that the task occupies. 


NOTE 


See the RSX-11M Operator's Procedures 


Manual for the Fix, Unfix, and Remove 
commands. 


The following restrictions apply to tasks that you want to fix in 
memory: 


@e You must first install the task. 
@ You cannot fix an active task. 


@ You cannot fix a checkpointable task. 


1.5.3 Priority 


Active tasks compete for system resources on the basis of their 
relative priorities. The Executive gives control of the processor to 
the active task that has the highest priority and that also has access 
to all the other resources it needs. When this task becomes blocked 
(while waiting for I/O to complete, for example), the Executive looks 
for another task to use the processor. The chosen task is again the 
one that has the highest priority and has access to all the resources 
it needs. 


You initially assign a default priority to a task when you task-build 
Lt This priority is a number between 1 and 250 (decimal); higher 
numbers indicate higher priority. Later, you can change the priority 
when you install the task; or the system can change the priority 
while the task is running (see Swapping). 


In an RSX-11M installation that mixes real-time applications with less 
urgent work, higher priority numbers should be assigned to the 
real-time tasks. This assignment ensures that the Executive gives 
processor time to the real-time tasks ahead of the others. Text 
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editors are an example of real-time tasks, because they must respond 
within a short time period. Text editors, commonly used for program 
development or text processing, spend a large part of their time 
waiting for terminal I/0 to complete and are therefore out of 
competition for processor time. However, when the I/O operation ends, 
the terminal needs a rapid response. To get the higher response, the 
installation system manager can assign to text editors a higher 
priority than that of more processor bound tasks like the Task Builder 
or Assembler. 


1.5.3.1 Establishing Task Priority - You can establish task priority 
when you use the Task Builder to build a task from an object module. 
See the RSX-11M Task Builder Reference Manual for a description of the 
priority option. 


1.5.3.2 Installed Priority - When you install a task using the 
Install command, you can specify a priority different from the one 
that you specified when you built the'task. The priority specified in 
the Install command overrides the priority that was specified for the 
task in the Task Builder command. See the RSX-11M Operator's 
Procedures Manual for a complete description of the Install command. 


1.5.3.3 Altering Priority - You may want to alter a task's priority 
after it is installed. The Alter command provides a way to change 
priority. With the Alter command you can change the task's’ static 
installed priority or change the task's running priority. However, 
you can make these changes only if the system supports the Alter 


Priority directive. See the RSX-11M Operator's Procedures Manual for 
a complete description of the Alter command. 


1.5.4 Round-robin Scheduling 


When numerous competing memory-resident tasks have equal priorities, 
the Executive tends to give processor time more often to those tasks 
that appear first in the System Task Directory (STD) queue. Entries 
with egual priorities normally appear in the STD in the order in which 
the tasks were installed. Therefore, the Executive favors tasks that 
were installed first. To avoid this problem, RSX-11M provides a 
system generation option called round-robin scheduling. Round-robin 
scheduling uses an algorithm that periodically rotates the execution 
of tasks of equal priority in the STD. The overall effect is that 
processor time is distributed more evenly among tasks. Each 
equal-priority task has its turn toward the head of the STD queue. 


1.5.5 Checkpointing 


In a programming system where many tasks of equal or different 
priorities are competing for memory space and system resources, the 
Executive must have a method of distributing processor usage and 
resources to all the tasks. The RSX-11M Executive uses a process 
called checkpointing to allocate system resources among tasks. The 
Executive uses task priority as the basis for the checkpointing 
scheme. 
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In some instances, an active task cannot get into memory and compete 
for processor resources because the partition in which it was 
installed is fully occupied. If the partition contains a task that 
has a lower priority and is checkpointable, the Executive moves that 
task out of memory and writes it on a disk to make room for the higher 
priority task. When the high priority task is finished, the Executive 
reloads the low priority task, which is now on the disk, to allow it 
to continue processing from the point at which it was interrupted. 
This roll-out, roll-in process is called checkpointing. 


RSX~11M supports checkpointing in both user-controlled and 
system—-controlled partitions. The objective is to avoid preempting a 
lower priority task, unless a higher priority task can be brought in 
to make use of the freed memory. This optimizes the use of system 
resources while maintaining a priority scheduling discipline. 


1.5.5.1 Disk Space for Checkpointing - To checkpoint a task, 
checkpoint space equal to the size of the partition that contains the 
task must be available on disk. (Checkpoint space contains the 
checkpointed task while a higher priority task executes.) You can 
allocate checkpoint space either statically when building the task, or 
dynamically at run time. You can use both kinds of checkpointing to 
balance the advantages and disadvantages of the different allocation 
methods. 


When you use the Task Builder to create a task from an object module, 
you can request checkpoint space allocation in the task image file on 
the disk; this is the same disk as the one on which the task resides. 
The task image file is the executable task on the disk. While the 
task is running, its checkpoint space is always allocated on disk, 
whether or not the Executive actually checkpoints the task. 


You can use disk space more efficiently if you allocate checkpoint 
space dynamically. Instead of reserving disk space equal to the size 
of each checkpointable task, you can create one or more checkpoint 
files on disk to contain all checkpointed tasks. The size of the 
files depends on an estimation of the checkpoint space required at any 
given time. When the system allocates checkpoint space dynamically, 
tasks need not be built as checkpointable. Instead, you decide if a 
task can be checkpointed when the task is installed. You create a 
checkpoint file, independent of individual tasks, by issuing the ACS 
(Allocate Checkpoint Space) command from the terminal. Then, when the 
Executive needs to checkpoint a task, it writes the task out into’ the 
available space in the checkpoint file. A drawback to dynamic 
allocation of checkpoint space is that space in a checkpoint file may, 
at times, be filled. However, system performance may be improved if 
the checkpoint file is on a fast disk. 


See the RSX-11M Operator's Procedures Manual for. the Allocate 
Checkpoint Space (ACS) command. 


1.5.6 Task Swapping 


The Executive must deal with the situation that occurs when several 
active tasks with egual priorities compete for partition space in 
memory. A task cannot normally cause the Executive to checkpoint 
another task with the same priority. Therefore, a task of equal 
priority cannot get into memory. The Executive includes a_e task 
swapping algorithm that uses checkpointing to allow tasks of egual 
priority to successfully compete for memory. 
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Swapping is a variation of checkpointing that enables the Executive to 
checkpoint tasks with egual priorities in and out of memory. Swapping 
does not work, of course, unless the tasks are checkpointable. When 
an eligible task begins to run, the Executive adds a number to the 
task's normal running priority. This number is called the swapping 
priority and is used for swapping only. The old running priority 
still exists. As the task runs, the Executive decrements the swapping 
priority. Eventually, the sum of the decremented swapping priority 
and the task's running priority causes the running task to have a 
priority (for swapping) less than that of a competing task. When this 
occurs, the Executive checkpoints the running task to make room for 
the competing task. The Executive then places the checkpointed task 
in the gueue of active tasks that are competing for memory. The 
Swapping priority does not affect task scheduling or 1/0 dispatching, 
which are governed solely by the task's running priority. 


1.5.7 The Shuffler Task 


In trying to accommodate the execution of as many tasks as possible, 
the Executive moves tasks in and out of memory depending upon 
available space, priority, etc. This operation can result in 
fragmented memory, a situation in which many small tasks occupy memory 
with unused spaces in between. Taken individually, these spaces may 
not be large enough to allow large tasks to be loaded and executed. 
The Shuffler task, a system generation option, solves this problem by 
performing memory compaction in a system-controlled partition. 


The Shuffler starts at the beginning of the system-controlled 
partition and tries to move (shuffle) all tasks that are sitting above 
a gap of free space down to the base of the free space. When 
possible, it also checkpoints any tasks that it encounters that are 
waiting for terminal input. 


If there are some tasks still actively competing for memory in the 
partition, the Shuffler creates an ascending, priority-ordered list of 
the tasks in the partition. If the sum of the free space now in the 
partition and the space occupied by the low priority, checkpointable 
tasks in the partition is enough to allow the waiting task to run, the 
Shuffler checkpoints the lower priority tasks. The Shuffler then 
compacts memory again to make room for the waiting task. 


The foregoing Shuffler action should result in all free space being at 
the top of the partition. However, there may be additional holes 
below tasks because some things (drivers and regions) cannot be 
shuffled. These additional holes cannot be reclaimed. 


1.5.8 Extended Logical Address Space 


An RSX-11M task specifies an address in a 16-bit word. The largest 
address that can be expressed in a 16-bit word is 65,536 bytes or 
32,768 words (commonly referred to as 32K words). To avoid limiting 
the effective size of a task to only 32K words, a task can use 
overlays that you define when you use the Task Builder to build the 
task. Another option is that the task can use memory management 
directives to access greater amounts of memory. 
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1.5.8.1 Overlays - An overlaid task has parts called segments. The 
segments are the parts that overlay one another. The segments are 
also sometimes called overlays. The root segment, which is always in 
memory and never overlaid, and one or more overlay segments compose an 
overlaid task. The overlay segments can be read into memory as 
reguired. However, all the segments in memory at one time cannot 
exceed 32K words. 


See the RSX-11M Task Builder Reference Manual for a complete 
description of overlay segments. 


1.5.8.2 Memory Management Directives - Memory management directives 
allow task segments resident in memory to access more than 32K words 
of physical memory. The memory management directives, a subset of the 
Executive directives, use the KT1l hardware to map task addresses to 
different logical areas within the task. Instead of displacing task 
segments in memory, the task can reside entirely in memory and map its 
virtual addresses to different physical addresses. 


RSX-11M defines three kinds of address space: 


e Physical address space. Physical address space consists of 
the physical memory in which tasks reside and execute. 


e Logical address space. Logical address space is the total 
amount of physical address space to which the task has access 
rights. 


@e Virtual address space. Virtual address space corresponds’ to 
the 32K of addresses that the task can explicitly specify in a 
16-bit word. If a task does not use memory management 
directives, its logical and virtual address spaces directly 
correspond one to the other. However, if the task uses these 
directives, it can map its virtual addresses to different 
parts of its logical address space. The net effect is to 
allow a task's logical address space to exceed 32K. 


The memory management directives also allow a task to expand 
dynamically its logical address space. In other words, a task can 
access logical areas that are not part of its static task image (the 
executable task produced by the Task Builder). A task can issue 
directives that create a new region of logical space and then map a 
range of virtual addresses to the newly created region. A task can 
also map its virtual addresses to logical areas that belong to another 
task. The mapped area then becomes part of the former task's logical 
address space. 


The ability to create and map to a new region allows tasks to 
communicate with one another by means of shared regions. For example, 
at run time a task can create a new region of logical space, into 
which it writes a large amount of data. Any number of tasks can then 
access that data by mapping a range of their virtual addresses to the 
region. Another benefit of mapping to different regions is an ability 
to use a greater number of common routines. Tasks can map to the 
required routines at run time, rather than link to them when the tasks 
are built by the Task Builder. 
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1.6 RSX-11M INTERRUPT PROCESSING 


The RSX-11M system recognizes two kinds of hardware interrupts: 
processor traps and external interrupts. Processor traps occur 
synchronously; that is, the same sequence of instructions causes the 
same processor trap to occur at the same place and time in the 
program. Processor traps usually have a cause originating from within 
the processor. See Processor Traps, in this chapter, for the causes 
of processor traps. External interrupts, which are usually caused by 
I/O devices, are asynchronous in that they may occur anywhere or at 
any time in the program's execution. 


Programs that use input and output routines would spend most of their 
time waiting for I/O devices to complete their operations if it were 
not for the program interrupt facility of RSX-11M. The program 
interrupt facility allows asynchronous events, such as I/O completion, 
to interrupt the running program so that a routine can service the 
interrupting device. An interrupt is analagous to a subroutine jump. 
However, to preserve program integrity, interrupts are allowed to 
occur only after the completion of an instruction and before the start 
of the next instruction. 


As an example of the program interrupt facility, programs can continue 
operation after starting a device, then allow the device to interrupt 
when it is ready to signal the program about its resulting status. 


The addresses of the interrupt processing routines must be made known 
to the Executive. These addresses are called interrupt vectors and 
they are in the Executive's low memory area. 


1.6.1 Interrupt Vectors 


Each peripheral device controller in the RSX-11M system has a hardware 
pointer to its own pair of memory words. These words are located in 
the low memory of the Executive. One word contains a vector (address) 
for the device's interrupt service routine. The vector may be an 
entry point address or an Interupt Control Block address. If this 
vector is an entry point address, it becomes the contents of R7 the 
program counter or PC word) when the service routine begins its 
execution. For loadable drivers, the vector points to an Interrupt 
Control Block. 


The other word is the processor status (PS) word. It contains the 
mode and the priority of operation for the interrupt routine. The 
hardware saves the status of the interrupted program (the PC and _ PS) 
before the interrupt routine begins its processing. 


The Executive has an area called a stack in which it saves status, 
register contents, parameters, or any other data that it may need. 


1.6.2 System Stack 


RSX-11M maintains a push-down stack using general register 6, which is 
the stack pointer or SP. External interrupts, subroutine calls, and 
processor traps use this stack to save program status. When an 
interrupt occurs, the hardware first saves the current processor 
status word (PS) and the program counter (PC) on the stack. It then 
uses the new PS and PC from the trap and interrupt vector area in low 
memory, and begins processing the interrupt routine that handles that 
particular interrupt. A return from interrupt (RTI) instruction 
restores the original PS and PC values from the stack, thereby 
restoring the original interrupted program. 


1-17 
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1.6.3 Processor Traps 


A variety of errors and programming conditions cause the processor to 
trap to a set of fixed locations. These locations contain the PC and 
PS for the trap processing routines. Processor traps include the 
following: 


@ Power failure 

e Odd addressing errors 

e Stack errors 

e Timeout errors 

e Non-existent memory errors 

@ Memory parity errors 

e Memory management violations 

e Floating point processor exceptions 
e Use of reserved instructions 

e Use of the T-bit in the PS word 

@e Use of the IOT, EMT, and TRAP instructions 


Processor traps cannot be masked off. That is, when they occur, the 
processor immediately enters the trap sequence of pushing the current 
PS and PC onto the current stack, retrieving the new PS and PC from a 
specific hardware trap vector, and executing the code that begins at 
the location specified by the trap vector. 


Although there are several processor traps (see Interrupt and Trap 
Vectors, below), the trap of main interest is the emulator trap. The 
EMT instruction causes the emulator trap. This instruction calls the 
Executive whenever a user task has an Executive directive written into 
it that requests the Executive to perform some specific function (see 
Executive Directives below). 


1.6.4 External Interruptions 


External interrupts are hard-wired into one of four priority levels of 
the processor (labeled 4 to 7, with 7 being the highest priority). 
These interrupts are maskable in that they can cause an interrupt only 
if the priority level held in the processor status word is less than 
the priority of the interrupting source. When an interrupting device 
causes a new priority level to be loaded from its vector PS word, 
interrupts at the same or lower levels are blocked out. The system, 
however, remembers that the interrupts occurred and it processes them 
in turn by priority. 


Certain traps, however, cannot be masked by the priority field in the 
PS word. These traps are: parity error, memory management violation, 
stack limit yellow, power failure (power down), and floating-point 
exception. 
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1.6.5 Interrupt And Trap Vector Locations 


The following chart shows some of the interrupt and trap vectors used 
by RSX-11M interrupt and trap processing. The PC for the interrupt 
routine is taken from the specified memory location. The next word 
contains the new PS word. 


Memory Interrupt and 
Location Trap Vector 
000 Reserved for DEC use 
004 CPU errors 7 
010 Illegal and reserved instructions 
014 Breakpoint trap (BPT) 
020 Input/output trap (IOT) 
024 Power fail 
030 Emulator trap 
034 TRAP instruction 
244 Floating-point error 
250 Memory management 


For a complete list of vectors, see the pertinent PDP1l1l Processor 
Handbook. 


1.6.6 System Traps 


System traps are transfers of control (also called software 
interrupts) that provide tasks with another means of monitoring and 
reacting to events. The Executive initiates system traps when certain 
events occur. The trap transfers control to the task associated with 
the event and gives the task the opportunity to service the event by 
entering a user-written routine. 


There are two distinct kinds of system traps: 


@e Synchronous System Traps (SSTs). SSTs detect events directly 
associated with program instruction execution. They are 
"synchronous" because they always occur at the same point in 
the program when previous instructions are repeated. For 
example, an illegal instruction. causes an SST to occur. 


@e Asynchronous System Traps (ASTs). ASTs detect significant 
events that occur asynchronously to the task's execution; 
that is, the task has no direct control over the precise time 
that the event occurs. For example, the completion of an I/0 
transfer may cause an AST to occur. 


To use the system traps, a task issues system directives that 
establish entry points for user-written service routines. Entry 
points for SSTs are specified in a single table. AST entry points are 
set by individual directives for each kind of AST. When a trap 
occurs, the task enters the appropriate routine via the specified 
entry point. 


Debugging aid programs (On-line Debugging Tool and Executive Debugging 
Tool) can be entered from points, which are called breakpoints, that 
you insert into a memory-resident task. These breakpoints cause a 
breakpoint trap that transfers execution to the debugging aid program. 
The debugging aid, by means of its own table of trap vectors, can 
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execute special processing for certain SSTs that can occur. The 
IAS/RSX-11 ODT Reference Manual discusses the On-line Debugging Tool 
in detail. The Executive Debugging Tool (XDT) is described in the 


RSX-11M Guide to Writing an I/O Driver. 


1.7 EXECUTIVE DIRECTIVES 

An Executive directive is a reguest from a task to the Executive to 
perform an indicated operation. A programmer uses Executive 
directives to control the execution and interaction of tasks. 


Executive directives enable tasks to perform functions such as_ the 
following: 


@e Obtain task and system ineormakion 

@ Measure time intervals 

e Perform I/O operations 

@e Manipulate a task's logical and virtual address space 
e Suspend and resume execution of tasks 

@® Reguest the execution of another task 

e Exit from a task 


System directives allow tasks to exploit some major system functions, 
including the following: 


@ Event flags 

e System traps 

@ Extended logical address space 
RSX-11M MACRO programs execute Executive directives by using macro 
calls and the EMT 377 instruction. FORTRAN uses DIGITAL~-supplied 
library routines to use the directives. 
You should always use macro calls instead of directly executing the 
directive. Then, if system changes are made in the directive 
specifications, you need only to reassemble the program rather than 
edit the source code. 
Listed below is a brief summary of the directive functions that are 


possible for RSX-11M. For a complete description of RSX-11M Executive 
directives, see the RSX-11M Executive Reference Manual. 


Task Execution Control Directives 


Abort Task Causes the Executive to terminate the 
execution of the task named in this 

directive. 
Cancel Time Based Causes the Executive to cancel 
Initiation Requests all time-synchronized initiation 


reguests for the execution of the task 
named in this directive, regardless of 
the source of each request. 
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Task Exit 


Extend Task 


Request Task 


Resume Task 


Run Task 


Suspend 


Task Status Control Directives 


Alter Priority 


Disable Checkpointing 


Enable Checkpointing 


Informational Directives 


Get Partition Parameters 


Get Region Parameters 


Get Sense Switches 


Informs the Executive that the task 
issuing the Exit has completed its 
execution. Unless the exiting task is 
fixed, its memory is freed for use by 
other tasks. 


Causes the Executive to modify the 
size of the task that issues this 
directive by a positive or negative 
number of 32-word blocks. 


Causes’ the Executive to request 
immediate execution of the task named 
in the directive. 


Causes the Executive to resume the 
execution of a task that has issued a 
Suspend directive. 


Causes the Executive to schedule the 
execution of the task named in this 
directive at a time specified in terms 
of atime period from the issuance of 
the directive. 


Causes’ the Executive to suspend 
execution of the task that issued the 
Suspend until explicitly resumed, 
either by a Resume directive from 
another task or the MCR command, 
Resume. 


Causes the Executive to change the 
running priority of the installed and 
active task named in this directive. 


Causes the Executive to make the task 
that issues this directive no longer 
checkpointable. 


Causes the Executive to nullify the 
previously issued Disable 
Checkpointing directive. 


Causes the Executive to fill a 3-word 
buffer, which is specified in this 
directive, with parameters related to 
the memory partition specified in this 
directive or related to the task that 
issues this directive. 


Causes the Executive to fill a 3-word 
buffer, which is specified in this 
directive, with region parameters. 


Causes the Executive to return the 
settings of the 16 console switches to 
the task that issues this directive. 
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Get Task Parameters 


Get Time Parameters 


Event-associated Directives 


Clear Event Flag 


Cancel Mark Time Requests 


Declare Significant Event 


Exitif£ 


Mark Time 


Read All Event Flags 


Set Event Flag 


Wait For Significant 
Event 


Causes the Executive to fill a 16-word 
buffer with parameters related to the 
task that issues this directive. 


Causes the Executive to return the 
current time parameters (year, month, 
day, hour, minute, second, tick and 
ticks/second) of the task. 


Causes the Executive to clear an event 
flag specified in the directive and 
return the previous polarity of the 
flag. 


Causes the Executive to cancel MARK 
TIME reguests that have been made by 
the task that issues this directive. 


Causes .the Executive to declare a 
significant event. The Executive 
scans the STD for the highest priority 
task capable of execution. It then 
saves the context of the currently 
executing task and starts the 
execution of the new highest priority 
task. 


Causes the Executive to cause an exit 
of the task that issues the directive 
if, and only if, a specified event 
flag is clear. 


Causes the Executive to declare a 
significant event after the expiration 
of the time interval specified in the 
directive. If an event flag is 
specified in the directive, it is 
cleared when the directive is issued 
and set when the significant event 
occurs. If an Asynchronous System 
Trap (AST) entry point address is 
specified in the directive, an AST 
occurs at the time of the significant 
event. 


Instructs the Executive to return to 
the task that issued this directive 
the polarities of all 64 event flags 
in a 4-word buffer. 


Causes the Executive to set an 
indicated event flag and return the 
previous polarity of the indicated 
flag (without a declaration of a 
Significant event). 


Causes the Executive to suspend the 
execution of the task that issues the 
directive until the next significant 
event occurs. 
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Wait For Logical Or Of 
Event Flags 


Wait For Single 
Event Flag 


Trap-associated Directives 


AST Service Exit 


Disable AST Recognition 


Enable AST Recognition 


Specify FPP Exception AST 


Specify Power Recovery 
AST 


Specify Receive Data AST 


Specify Receive By 
Reference AST 


Specify SST Vector Table 
For Debugging Aid 


Causes the Executive to suspend the 
execution of the task that issues the 
directive until one or more specified 
event flags of a group of event flags 
is set. 


Instructs the executive to suspend the 
execution of the task that issues’ the 
directive until an event flag that is 
specified in the directive is set. 


Causes the Executive to terminate the 
execution of the AST service routine. 


Causes the Executive to disable AST 
recognition for the task that issues 
this directive. The ASTsS are gueued 
and only their recognition is 
inhibited. 


Causes the Executive to enable AST 
recognition for the task that issues 
this directive. 


Informs the Executive that the 
specified AST routine within the task 
is to begin execution whenever a 
floating-point processor exception 
occurs, or that floating-point 
processor exception ASTs are no longer 
wanted. 


Informs the Executive whether or not 
power recovery ASTs are wanted for the 
task that issues this directive. If 
the ASTs are wanted, this directive 
indicates where control is to be 
transferred when the AST occurs. 


Informs the Executive whether or not 
receive data ASTs for the task issuing 
this directive are wanted. If the 
ASTS are wanted, task execution is 
transferred to the address of the AST 
service routine within the task when 
data is placed in the task's' receive 
queue. 


Informs the Executive to transfer 
control to an address in the _ task 
specified in the directive when the 
Receive-by-Reference AST occurs, or 
that receive~by-reference ASTs are no 
longer desired for the task that 
issued this directive. 


Specifies the address of a table of 
synchronous system trap service 
routine entry points for use by ODT or 
other debugging aids. 
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Specify SST Vector Table 
For Task 


Informs the Executive that the task 
that issues this directive contains a 
table of addresses of service routines 
to be executed upon task trap or fault 
conditions. 


I/O and Intertask Related Directives 


Assign LUN 
Connect To Interrupt 
Vector 


Get LUN Information 


Get MCR Command Line 


Queue I/O Reguest 


Queue I/O Reguest 
And Wait 


Receive Data 


Receive Data Or Exit 


Send Data 


Causes the Executive to assign a 
physical device unit to a logical unit 
number (LUN). The LUN, device name, 
and device unit number are specified 
in this directive. 


Causes the Executive to allow a_ task 
to process hardware interrupts by a 
routine specified in the directive. 
The Interrupt Service Routine (ISR) 
must be in the task's own space. 


Causes the Executive to return 
information regarding the logical unit 
specified in the directive to the task 
that issues this directive. 


Causes the Executive to transfer an 
MCR (terminal) command line to the 
task that issues this directive. 


Causes the Executive to queue an 1/0 
reguest for the issuing task. This 
reguest is gueued by priority for a 
logical unit which is assigned to a 
physical unit. An event flag, an AST, 
and an I/O status block may be 
specified as I/O completion 
indications. 


Similar to the gueue I/0 request 
directive except for one aspect. The 
Queue I/O Reguest And Wait directive 
specifies an event flag and the 
Executive executes an implied Wait For 
Single Event Flag directive. 


Informs the Executive that the task 
that issues this directive is ready to 
receive data (in a 13=-word data block) 
that has been sent from another task 
by means of the Send directive. 


Causes the Executive to attempt to 
receive data (dequeue a 13-word data 
block) for the task that issues this 
directive. If no data is received, 
the task that issues this directive 
exits. 


Causes the Executive to declare a 
significant event and to queue the 
l3-word block of data that the task 
named in this directive is to receive. 


he 
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Memory Management Directives 


Attach Region Causes the Executive to attach the 
task that issues this directive to a 
static common region or to a named 
dynamic region. 


Create Address Window Causes the Executive to create a new 
virtual address window by allocating a 
window block from the header of the 
task that issues this directive and 
establishing the window's virtual 
address base and size. 


Create Region Causes the Executive to create a 
dynamic region in a system-controlled 
partition and, as an option, attach it 
to the task that issues this 
directive. 


Detach Region Causes the Executive to detach the 
task that issues this directive from 
the previously attached region that is 
specified in this directive. 


Eliminate Address Window Causes the Executive to delete an 
existing address window, unmapping it 
first if necessary. 


Get Mapping Context Causes the Executive to return a 
description of the current 
window-to-region mapping assignments. 

Map Address Window Causes the Executive to map an 
existing window to an attached region. 

Receive By Reference Causes the Executive to dequeue the 
next packet in the 


receive-by-reference gueue of the task 
that issues this directive. 


Send By Reference Causes the Executive to insert a 
packet containing a reference toa 
region into the receive-by-reference 
gueue of a receiver task that is 
specified in this directive. 


Unmap Address Window Causes the Executive to unmap- the 
window that is specified in this 
directive. 


1.7.1 Event Flags 


The execution of certain directives causes significant events to 
occur. In fact, most significant events are caused, either directly 
or indirectly, by system directives. 


A significant event occurs when a task issues a system directive that 
implicitly or explicitly suspends a task's execution, or when an 
external interrupt occurs that can affect a task's execution. Event 
flags are associated with significant events. When a significant 
event occurs, the event flag indicates the specific cause of the 
Significant event. 
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The Executive uses significant events and event flags to manage task 
execution. However, tasks can also use significant events to 
coordinate internal task activity and to communicate with other tasks. 
For example, a task can issue an Executive directive to associate an 
event flag with a specific significant event. When that event occurs, 
the Executive sets the associated flag. Therefore, by testing the 
state of the flag, a task can determine whether or not the event has 
occurred. 


Sixty-four event flags are available to enable tasks to distinguish 
one event from another. Each event flag has a corresponding event 
flag number. The first 32 flags are local to each task and are set or 
Cleared as a result of each task's reguirements. The second 32 flags 
are common to all tasks and are therefore called global or common 
event flags. Global flags can be set or cleared as a result of any 
task's operation. Tasks use global flags to communicate with other 
tasks because one task cannot refer to another task's local flags. 
Eight of the local event flags and eight of the common event flags are 
reserved exclusively for the Executive. 


1.8 THE MCR INTERFACE 


You communicate with RSX-11M by entering commands at a terminal. The 
terminal driver directs the commands to the Monitor Console Routine 
(MCR) processor. The MCR processor either executes the commands 
itself, or it activates a system or user-written task that can service 
the commands. 


MCR commands allow you to: 
@e Start up the system 
@ Manage peripheral devices 
@ Control task execution 
e Obtain system and task information 


@ Activate system or user-written tasks that reguest input from 
the terminal 


The MCR commands that control task execution are particularly 
significant to system performance. You must use an MCR command 
(Install) to install a task into the system. Therefore, you establish 
the base of installed tasks, which the Executive, other installed and 
active tasks, and further MCR commands can manipulate. 


1.8.1 Privileged Commands 


To restrict the use of commands that directly affect system 
performance, RSX-11M considers some MCR commands and command options 
to be privileged. You can issue a privileged command only from a 
privileged terminal. In multiuser protection systems, individual 
users are either priviléged or nonprivileged; when a user logs on, 
the terminal assumes the privilege status assigned to that user's 
identification code (UIC). A user can issue an MCR command at a 
privileged terminal to modify the privilege status of any other 
terminal connected to the system. If multiuser protection support is 
not included during system generation, all terminals are privileged. 
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1.8.2 External Scheduling Of Task Execution 


An important MCR function is the external scheduling of task 
execution. This type of scheduling works in conjunction with the 
Executive's priority driven internal scheduling of active tasks. You 
can include time parameters with the command that activates an 
installed task. The time parameters request the Executive to run a 
tasks: 


@e At a specified time from the current moment 

@ At a specified time from clock unit synchronization 
@ At an absolute time of day 

e Immediately 


All of these time options are available with or without periodic 
rescheduling. RSX-11M also supports an unlimited number of programmed 
timers for each task in the system. The user task can create its own 
timer, which the Executive then decrements at regular intervals. When 
the timer reaches zero, the Executive sets an event flag or generates 
an Asynchronous System Trap (AST) that passes control to the task at a 
prespecified address. 


1.9 TERMINAL OPERATION 


In RSX-11M, a variable number of terminals can operate concurrently. 
In addition, each terminal operates independently of others in the 
system to allow each to run a different task. In a system that 
Supports multiuser protection, a user must log onto a terminal before 
issuing further commands. In other RSX-11M systems, a user can issue 
commands whenever the terminal displays an appropriate prompt. 


1.9.1 Attached Terminals 


RSX-11M allows tasks to request input from a terminal. To ensure that 
a reguesting task receives input intended for it, the task usually 
attaches to the terminal. While the task is attached, the terminal 
directs all input to the attached task, with one exception. The 
exception is a control C character (the C key pressed while pressing 
the CTRL key), which gains the attention of the MCR processor. An 
attached terminal ensures that a soliciting task properly receives its 
input; but it also allows a user to interrupt the task's control of 
the terminal to communicate with MCR. Note that attaching to the 
terminal is a function of the task rather than of a user. 


Some applications may require that a user be denied access to MCR but 
allowed access to a specific task only. In this case, a task can 
attach to the terminal with a special subfunction. The subfunction 
causes the system to generate an AST for the attached task whenever 
someone enters unrequested input, including CTRL/C, at the terminal. 
However, making the terminal a slave terminal is another way of doing 
this. 
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1.9.2 Slave Terminals 


When your installation needs to dedicate a terminal exclusively to one 
or more tasks, you issue an MCR command (or a task issues a special 
I/O function) that sets the terminal to slave status. The difference 
between a slave terminal and an attached terminal is that the system 
ignores all unsolicited input, including CTRL/C, that is entered at a 
slave terminal. Until you issue another MCR command to delete the 
Slave status, the terminal can only be used to communicate with the 
task soliciting input from the terminal. An I/O function issued by a 
task can also delete the slave status of the terminal. Slave 
terminals are often dedicated to real-time applications. 


1.10 MULTIUSER PROTECTION 


Multiuser protection, a system generation option, allows an RSX-11M 
installation to monitor and control individual users of the system. 
Individual users are either privileged or nonprivileged. The system 
manager, who is the one assigned responsibility for system 
configuration and operation, assigns a user identification code (UIC) 
to each user, which determines the user's privilege status. When 
logging onto a terminal, the user supplies a last name or UIC and a 
password. If the user gives a name, the system finds the associated 
UIC. The system then checks that the password matches the last name 
or UIC, and sets the terminal to privileged or nonprivileged status, 
according to the user's UIC. 


1.10.1 Public And Private Devices 


In a multiuser protection system, some commands allow you to do things 
that are not allowed in systems without multiuser protection. For 
example, the Allocate command allows you (or any user) to allocate a 
device (a disk drive) as your private device; allocating the device 
prevents other nonprivileged users from accessing it. 


A nonprivileged user can access a private device that he has allocated 
to perform MCR functions that are normally privileged. These 
functions include preparing a disk or magnetic tape for use by the 
RSX-11M file system. 


To complement the private device feature, multiuser protection allows 
the system manager or privileged user to declare certain devices to be 
public. Public devices cannot be allocated to individual users. By 
declaring a line printer to be public, for example, the system manager 
can ensure that all users have access to that commonly used output 
device. 


l.11 SYSTEM MAINTENANCE 


1.11.1 Error Logging 


RSX-11M provides an error logging facility as a system generation 
option for systems that are 24K words or larger. The error logging 
facility monitors the hardware reliability of an RSX-11M_ system; it 
continually detects and records information about disk, DECtape, 
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Magtape, and memory errors as they occur, regardless of whether or not 
the error is recoverable. The Executive automatically retries 
recoverable errors. However, you might be unaware that the error 
occurred. Therefore, at user-determined intervals, a formatting task 


can be run to generate individual error and summary reports on some or 
all of these errors. . 


Please note that only the following four types of errors are loggable: 
@e Device errors (disks, magtapes, DECtapes) 
@e Undefined interrupts © 
@ Timeout 
@ Memory parity errors 


In summary, the error logging facility performs the following 
functions: 


e Detects a hardware error as it occurs (done by Executive 
modules) 


@e Gathers information about the error 
e Stores the information in a file 
e@e Formats the information to produce an error report 


Control of the facility is shared between routines in the Executive 
and specific error logging tasks. These routines and tasks interface 
with each other to carry out the four operations described above. 


You can generate a wide variety of error reports. Among many options, 
you can specify a report that covers only a certain time period, a 
certain device or group of devices, or perhaps a certain type of 
error. You can also request a report that contains only information 
on individual errors, one that contains only summary information, or 
one that contains both kinds of statistics. 


Because the error log files may be written to a removable volume, an 
operator can generate the reports either on site or at any other 
RSX-11M installation that supports the error logging facility. 


1.11.2 Diagnostic Tasks 


RSX-11M also provides a group of diagnostic tasks which you can 
incorporate into the Executive support at system generation time. A 
diagnostic task tests a specific device to identify the source of any 
errors. RSX-11M diagnostic tasks test for malfunctions on most disks, 
DECtapes, magnetic tapes, and terminals. The tasks are simple to use 
and reguire little memory space. 


When used in connection with error logging reports, the diagnostic 
tasks can significantly reduce system downtime. The system manager 
should regularly generate error reports to check on hardware 
performance. When a number of errors indicates that a particular 
device is beginning to malfunction, the manager can run the diagnostic 
task for the erring device to help isolate the source of the errors. 


Each diagnostic task has two modes of operation: customer mode _= and 
service mode. In customer mode, the user activates the appropriate 
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task, which then runs to completion and reports its findings. 
(Because the tests destroy any data resident on the device being 
tested, only authorized users should be allowed to run diagnostic 
tasks.) Service mode is intended for use by DIGITAL Field Service 
engineers. Service mode allows the user to modify the test content 
initially and to interrupt the running test to make further 
modifications. 


1.11.3 Power Failure Restart 


RSX-11M can execute a power failure restart that smooths out 
intermittent short-term power fluctuations with little loss of service 
or data. Power failure restart functions in four phases: 


@ When power begins to fail, the CPU traps to the Executive, 
which stores volatile register contents, thereby bringing 
system operations to a controlled halt. 


@ When power is restored, the Executive again receives control 
and restores the preserved state of the system. 


@ The Executive then schedules all device drivers that were 
active at the time of the power failure at their power-fail 
entry points. Drivers have the option of being scheduled one 
of two ways: 


1. Whenever power fails 


2. Only when power fails while the driver is servicing an I/O 
request 


The drivers can then make any necessary restorations of state 
(repeat an I/O transfer, for example). 


@e The Executive then determines if any user-level tasks have 
reguested notification of power failure by issuing a system 
directive reguesting an AST on power recovery. The Executive 
initiates ASTs for any tasks that have requested them. 


CHAPTER 2 
MEMORY RESOURCE ALLOCATION 


2.1 INTRODUCTION 


Chapter 2 contains information about how the Executive manages, 
structures, allocates, and deallocates memory resources in RSX-11M. 
Any discussion of memory functions in RSX-11M necessarily overlaps the 
closely related functions of task management and processing. However, 
this discussion emphasizes memory allocation, deallocation, and 
Management to allow a more logical and coherent presentation of memory 
in RSX-11M. 


The functions of the core allocation routines, the Shuffler and _ the 
Loader, are part of Executive memory management. However, the term 
"memory management" also refers to the KT11 Memory Management Unit, 
which is hardware and not’ software. The use of the term "memory 
Management" has been avoided in this manual where confusion between 
the Executive's role and the hardware's role in memory management 
would arise. At the end of this chapter, flow diagrams show important 
processes that the Executive performs to allocate and manage memory. 


2.1.1 Memory Addressing 


Because of the 16-bit word size of the PDP-1l1, an RSX-11M task can 
have an address.no larger than 177777(8) (an addressing range of 32K 
words for nonprivileged tasks). In RSX-11M, you can use a task that 
contains overlays to avoid limiting its size to its addressing range. 
An overlaid task contains segments -- a root segment that is always in 
Memory, and any number of other segments that are loaded into memory 
when reguired. When task segments are not in memory, they reside on 
disk. Large task segments that are in memory may not be able to 
access large amounts of disk-based data because the data may not fit 
into the available memory with the task. A heavily overlaid task that 
transfers large amounts of data to another task via disk incurs a 
throughput penalty because of the many I/O transfers needed to move 
segments in addition to those I/O transfers needed by the task's 
function. . 


The combined size of an overlaid task's segments may exceed 32K, which 
is the limit imposed by 16-bit addressing. Normally, the sum of task 
segment sizes in memory is 32K or less. However, a non-privileged 
task can exceed the 32K physical size imposed by the 16-bit address 
structure by using the memory management programmed logical address 
space (PLAS) directives. Combining the PLAS directives with 
memory-resident overlays is an effective way to avoid throughput 
problems caused by many I/0 transfers. With this combination, I/0 
transfers occur to move only data to another task and, because the 
entire task is in memory, all or most of the task segments do not have 
to be loaded or unloaded during task execution. 


MEMORY RESOURCE ALLOCATION 


Task throughput can be faster if all or a greater portion of the task 
is resident in memory during task execution. RSX-11M contains a group 
of memory management directives that provide the task with this 
capability. The directives overcome the 32K word addressing 
restriction. They allow the task to change the physical memory 
locations referred to by a given range of addresses. Using these 
directives, a task can increase its execution speed by reducing its 
disk I/O requirements at the expense of increased memory requirements. 


The memory management directives that a task can use for expanding the 
32K range of accessible addresses are: 


CRRGS -- Create Region 

ATRGS -- Attach Region 

DTRGS$ -- Detach Region 

CRAWS -- Create Address Window 

ELAWS -- Eliminate Address Window 

MAPS -- Map Address Window 

UNMAPS -- Unmap Address Window 

SREF$ -- Send by Reference 

RREFS$ -- Receive by Reference 

GMCX$ -- Get Mapping Context 

GREGS$S -- Get Region Parameters . 
The use of these directives is fully described in the RSX-11M 


Executive Reference Manual. The RSX-11M Task Builder Reference Manual 
describes overlay structures and overlaid tasks. 


2.1.2 Memory Management - An Overview 


In a mapped system, the KTl1l1 Memory Management Unit associates task 
addresses with available physical memory. This process, which is 
transparent to the user, is called mapping. Addresses used within a 
task are virtual addresses and their correspondence to actual physical 
memory addresses is known to the kKT1ll unit only. However, memory 
Management directives can control and manipulate the KT11, which 
physically performs the address mapping. 


A privileged task can address all of available memory by directly 
using the KTl1l1 Memory Management Unit. There is some danger in doing 
this because the programmer must be very certain that the task does 
not corrupt system space, system routines and data (for instance, the 
Executive itself, its pool space, or the I/O page), or other tasks. 


2.1.3 Virtual And Logical Addresses 


Virtual and logical addresses, and virtual and logical address space 
are concepts that provide a basis for understanding the functions 
performed by memory management directives and the use of task windows. 
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Physical addresses ~ Memory is divided into discrete 
addressable parts called bytes. They are numbered according 
to their position in memory. Therefore, the lowest byte is 0 
and the highest byte is whatever the upper limit of memory may 
be for a particular system; for example, 32K, 64K, etc. The 
assigned number is called the physical address. 


A task contains virtual addresses (for example, 0 through 
2200). The - Task Builder relocates the task's virtual 
addresses in an unmapped system by a number represented by the 
base address of the partition in which it is installed. After 
installation, the task's addresses refer to logical addresses 
of memory, which always correspond to the same physical memory 
in an unmapped system (unless you change the partition or task 
code). Therefore, the addresses have an actual one-to-one 
relationship to physical memory. The same relationship exists 
any time the task is in memory. The logical addresses may not 
be from 0 through 2200. For example, after the task is 
installed in the partition, the task's virtual address 0 may 
become logical and physical address 17000 because the Task 
Builder added in the offset, which is equal to the partition 
base address. In a mapped system, the virtual addresses 
remain the same but the logical addresses may change due to 
Executive processes (checkpointing, Swapping, ete.) 
Therefore, the logical addresses do not always refer to the 
same physical memory. If the task uses memory management 
directives, the logical addressing can be changed by the task 
to include any part of physical memory that it is allowed to 
access. 


Virtual addresses -- A task's virtual addresses are the 
addresses within the task. The PDP-11l's 16-bit word length (a 
mapped system) imposes the address range of 32K-words on _ the 
virtual addresses. Therefore, these task addresses could 
include addresses zero through 177777(8) depending on the 
length of the task. However, in a system that uses the KT1l 
(mapped system), these task addresses may not be the same as 
the actual addresses of the memory in which the task resides. 
The KT11 Memory Management Unit maps the task's virtual 
addresses to the logical addresses of memory. 


Virtual address space -- A task's virtual address space is 
that space encompassed by the range of virtual addresses that 
the task uses. With the CRAWS memory management directive, a 
task can divide its virtual address space into segments called 
virtual address windows. By using address windows, you can 
manipulate the mapping of virtual addresses to different areas 
of physical memory (see Virtual Address Windows below). 


Logical addresses -- A task's logical addresses are the actual 
physical memory addresses that the task can access, 


Logical address space -- The task's logical address space is 
the total amount of physical memory to which the task has 
access rights. The physical memory represented by the logical 
addresses may or may not be continuous. In other words, 
though a task's virtual addresses may be continuous, its 
logical address space may be divided among non-adjacent parts 
of physical memory. Using the CRRGS (Create Region) memory 
Management directive, you can divide the task's logical 
address space into various areas called regions. Each region 
is a continuous block of memory; however, the regions may not 
be adjacent. 
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If the capabilities of the memory management directives were not 
available, a nonprivileged task's virtual address space and logical 
address space would directly correspond. That is, a single virtual 
address would always point to the same logical location. Both types 
of address space would have a maximum size of 32K. However, you’ can 
use directives to assign a range of virtual addresses (a window) to 
different logical areas (regions), thereby extending a task's logical 
address space beyond 32K words. 


Figure 2-1 shows a virtual address in a user task translated into a 
logical address in physical memory by the KT11 Memory Management Unit. 
The paragraphs following Figure 2-1 briefly describe the task virtual 
space, memory management, and task logical space relationships. A 
complete discussion of tasks, task windows, and regions can be found 
in the RSX-11M Task Builder Manual. Task mapping is also discussed in 
Chapter 4, Privileged Tasks. 


2.1.4 Task Windows 


Referring to Figure 2-1, which illustrates a mapped system, you can 
observe that a large 32K user task contains three distinct areas of 
continuous space called “windows". When referring to task windows (a 
file window is a similar but slightly different concept) the term, 
window, is a construct that encompasses and defines an area of 
continuous, virtual, program space in the task. Windows must have a 
specified size and starting address. The window size can be from 32 
words to 32K-32 words and windows must start on a 4K address boundary. 
Figure 2-1 shows three windows that are not continuous in the task's 
virtual address space. However, the space within each window is 
continuous. In this task, the size of window 0 is 11K; the size of 
window 1 is 11K; and the size of window 2 is 8K. The concept of 
windows exists for the following specific reason. 


By using the concept of windows and the Memory Management directives, 
a nonprivileged task can access a larger logical memory space than 
that implied by the 32K virtual addressing range and normally 
accessible by the 16-bit address. A task can, in fact, only access 
32K of memory at one time. However, a nonprivileged task can change 
its access to logical addresses (real, physical memory). The area 
that your program accesses can be changed by the program during 
program execution. The process of accessing different logical areas 
of memory is called "mapping". By referring to Figure 2-1, you can 
see that Window 1 in the task is mapped to Static Common Region 1 in 
physical memory. The Window 1 mapping can be changed by the task _ to 
Map to Static Common Region 0 in physical memory. In effect then, 
though a task is limited to a range of 32K virtual addresses, a_ task 
can access all the physical memory available to it (determined by the 
way that you set up the mapping) by changing the mapping of its 
windows to different logical addresses. Figure 2-1 provides a visual 
description of the concept of mapping to different logical addresses. 
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Figure 2-1 shows a task that has three windows. One of the windows 
can Map to two different: logical areas of memory. Window 0 in the 
task maps to the task region. The task region is 11K in size and this 
size corresponds to the size of Window 0 in the task. The task region 
contains the task root and header. The program cannot change this 
Mapping because window 0 is a default of the Task Builder and must 
contain the root and header. If no windows were specified, the Task 
Builder would create Window 0 for the entire task to map to its own 
logical space in memory. Window 1 maps to Static Common Region 1. 
Window 1 and Static Common Region 1 are both 11K in size. The task 
can change the mapping of Window 1 to map to Static Common Region 0. 
Observe here that the task can access 11K more physical memory than it 
occupies. In other words, a task of this size (32K), without windows, 
can access 32K of memory. The task that is illustrated can access 43K 
of memory. 


The last window, Window 2, accesses the Dynamic Common Region. Both 
Window 2 and the Dynamic Common Region are 8k in size. 


Note that the spaces that exist between the windows in the illustrated 
task do not refer to any logical memory address because no window 
(mapping) exists for those spaces. 


The discussion now proceeds to setting up the task's windows. This is 
done by defining task window blocks to the Task Builder. 


To manipulate virtual address mapping to various logical areas, the 
programmer must first divide a task's 32K of virtual address space 
into segments. These segments are task (virtual address) windows. 
Each window encompasses a continuous range of virtual addresses. The 
first address of the window address range must be a multiple of 4K 
{the first address must begin on a 4K boundary) because of the way 
that the KT-1l Memory Management Unit uses Aetire Page Registers 
(APRs). The number of windows defined in a task can vary from 1 to 7. 
Window 0 is not available to non-privileged tasks. The size of each 
window can range from a minimum of 32 words to a maximum of 32K minus 
32 words. 


A task that includes directives that dynamically manipulate address 
windows must have task window blocks set up in its task header as well 
as Window Definition Blocks in the code for use by the Create Address 
Window directive. The Executive uses task window blocks to identify 
and describe each currently existing window. When linking the task, 
the programmer specifies the number of window blocks to be set up by 
the Task Builder. The number of blocks should equal the maximum 
number of windows that will exist concurrently while the task is 
running. 


A window's identification is a number from 0 to 7, which is an index 
to the window's corresponding window block. The address window 
identified by 0 is the window that always maps the task's header and 
root segment. The Task Builder creates window 0, which the Executive 
uses to map the task. No directive should specify window 0. 


When a task uses memory management directives, the Executive views the 
relationship between the task's virtual and logical address space in 
terms of windows and regions. Unless a virtual address is part of an 
existing address window, the address does not point anywhere. This is 
a point to watch when setting up windows with the Create Address 
Window directive (CRAWS). Similarly, a window can be mapped only to 
an area that is all or part of an existing region within the task's 
logical address space. 
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Once a task has defined the necessary windows and regions, the task 
can issue memory management directives to perform operations such as 
the following: 


@ Map a window to all or part of a region. 


@ Unmap a window from one region in order to map it to another 
region. 


e Unmap a window from one part of a region in order to map it to 
another part of the same region. 


NOTE 


It is currently possible for a task with 
outstanding I/O to unmap from a region 
although it cannot detach from a_ region 
under this condition. Because this 
feature may be impossible to support in 
future releases of the system, DIGITAL 
recommends that users consider carefully 
before designing an application based on 
this ability. 


2.1.4.1 Task Window Block - A task that includes Memory Management 
directives to manipulate address windows must have window blocks set 
up in the task header. The Executive uses the task window blocks to 
identify and describe each currently existing window. When linking 
the task you must specify the number of window blocks to be set up by 
the Task Builder. To do this, you specify a number in the WNDWS 
options of the Task Builder to define the number of windows to be used 
(in addition to the default window, Window 0). The Task Builder 
reserves space in the task header for window blocks - one block for 
each window. The Task Builder always reserves at least one block (for 
Window 0) as a default. 


The label block group in the task header contains the number of task 
windows. The word where this number is found is LS$BWND. The number 
that is contained here does not include windows for libraries. 


The variable part of the task header contains the window blocks. You 
must specify window size, address limits, etc. (see Window Definition 
Block). However, task window blocks are filled in by the Executive 
when it obtains the information that you have described in the Window 
Definition Block (WDB) and Region Definition Block (RDB). Note that 
the RSX-11M Executive Reference Manual contains all the information 
that you need to establish address windows, regions, and their 
respective blocks in your code. Also, the RSX-11M Task Builder Manual 
contains a description of the task header. 


2.1.4.2 Window Definition Block (WDB) - The Window Definition Block 
is a coding structure that you must create by using the WDBDF$ and 
WDBBK$ macros if you are using MACRO-11. You can create this block 
with an 8-word integer array if you are using FORTRAN. The Window 
Definition Block defines all the parameters that your code, the 
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Executive, and the Task Builder need to use windows. The Window 
Definition Block contains the: 


e Window's base APR: 
APRO = Virtual base address 0 
APR1 = Virtual base address 4K 
APR2 = Virtual base address 8K 


APR7 = Virtual base address 28K 
e Size of the window in 32-word blocks 
@® Region ID of the region to map 
e Offset within region to be mapped in 32-word blocks 
@ Window status word bit definitions 
e Send/Receive buffer virtual address 


The window's base APR and the size of the window are information that 
the Executive needs. The region ID relates the window to the Region 
Definition Block (RDB) which is also created by you. The offset 
within the region determines where the mapped area starts within the 
region. You can change the offset to move the area that is mapped 
within the region. The RSX-11M Executive Reference Manual contains a 


complete description of creating and using the WDB and the RDB. 


2.1.5 Regions 


A task's current window-to-region mapping context determines the part 
of the task's logical address space that the task can access at one 
time. A task's logical address space can consist of various types of 
region: 


® Task Region -~ The task region is a continuous block of memory 
in which the task runs. 


@e Static Common Region -- A static common region is an area 
defined by an operator at run time or during system 
generation; for example, a global common area. 


® Dynamic Region -- A dynamic region is a region created 
dynamically at run time by using the Create Region (CRRG$) 
memory management directive in the task. 


Tasks refer to a region by using a region ID, which the Executive 
returns to the task after the task creates the region. The Executive 
returns the region ID in the R.GID field of the Region Definition 
Block that the user must create before using the Create Region 
directive. Region ID 0 always refers to a task's task region. All 
other region IDs are actually addresses of the attachment descriptor 
maintained by the Executive in the system's dynamic storage region. 


Figure 2-1 shows a sample collection of regions that could make up a 
task's logical address space. A task's logical address space can 
expand and contract dynamically as the task issues the appropriate 
memory management directives. The header and root segment are always 
part of the task region. Therefore, the task header and root segment 
always use window 0 (UAPR 0) and region 0. Because a region occupies 
a continuous area of memory, each region is shown as a separate block. 
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2.1.5.1 Shared Regions - Address mapping not only extends a_ task's 
logical address space beyond 32K words, it also allows the space to 
extend to regions that have not been linked to the task at task-build 
time. One result is an increased potential for task interaction by 
means of shared regions. For example, a task can create a dynamic 
region to accomodate large amounts of data. Any number of tasks can 
then access that data by mapping to the region. Another result is the 
ability of tasks to use a greater number of common routines. Tasks 
can map to reguired routines at run time, rather than link to them at 
task-build time. 


2.1.5.2 Attaching to Regions - A task attaches to a region to make 
that region a part of the task's logical address space. A task can 
map only to a region that is part of the task's logical address space. 
There are three ways to attach a task to a region: 


1. All regions that are linked to a task at task-build time are 
automatically attached. 


2. A task can issue a directive to attach itself to a named 
static common region or a named dynamic region. 


3. A task can request the Executive to attach any region within 
its own logical address space (other than its task region) to 
another specified task. 


Attaching identifies a task as a user of a region, and prevents the 
system from deleting a region until all tasks have been detached from 
it. (It should be noted that fixed tasks do not automatically become 
detached from regions upon exiting.) 


2.1.5.3 Region Protection - A task cannot indiscriminately attach to 
any region. The following criteria determine how tasks can attach to 
regions outside their logical address space: 


@e Each region has a protection mask to prevent unauthorized 
access. The mask indicates the types of access (read, write, 
extend, delete) allowed for each category of user (system, 
owner, group, world). The Executive checks that the 
requesting task's User Identification Code (UIC) allows it to 
make the attempted access. The attempt fails if the 
protection mask denies that task the access it wants. 


@ When a task creates a dynamic region, it may or may not give 
that region a name. If the dynamic region is named, any task 
can map to it as long as it knows the name and there is no 
protection violation. If a dynamic region is unnamed, a-task 
can map to the region only if the task that created the 
dynamic region issues a Send By Reference directive addressed 
to the requesting task. 


e Any task can issue a Send By Reference directive to attach any 
region (except the task region) to another specific task. The 
reference sent includes the access rights with which’ the 
receiving task attaches to the region. The sending task can 
only grant access rights that it has itself. 


e Any task can map to a named static common region as long as 
there is no protection violation. 
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2.1.5.4 Region Definition Block (RDB) - You must create the Region 
Definition Block for each dynamically created region with the RDBDFS 
and RDBBKS$ macros if you are using MACRO-1l. You can create the RDB 
with an 8-word single-precision array if you are using FORTRAN. 


The RDB contains the: 
® Region ID 
@e Region size in 32-word blocks 
@e Region name (in RAD50) 
@ Name of the partition (in RAD50) in which to create the region 
® Region status word 
e Region default protection 


The RSX-11M Executive Reference Manual contains a complete description 
of creating and using the RDB. 


2.2 MEMORY ALLOCATION 


This section contains a textual discussion of the major functions and 
units of memory allocation. These are: checkpointing, swapping, 
memory compaction (the Shuffler), and loading (the Loader task). Flow 
diagrams of the major routines that are involved in these processes 
are included at the end of the memory allocation section. 


This section also includes flow diagrams of the Loader, Shuffler, 
SNXTSK, and related routines called by SNXTSK. 


2.2.1 Checkpointing 


RSX-11M supports checkpointing in both user~ and system-controlled 
partitions. The objective of checkpointing is to prevent lower 
priority tasks from using main memory and thereby preventing its use 
by higher priority tasks. 


2.2.1.1 Checkpointing in User-controlled Partitions - Checkpointing 
in a user-controlled partition occurs under one of two conditions: 


e A task reguires the user-controlled main partition and has a 
higher priority than any other task currently occupying it or 
any of its subpartitions. Furthermore, all the occupying 
tasks must be checkpointable and have checkpointing enabled. 
If all of these conditions are met, the Executive checkpoints 
all the tasks that occupy the partition and gives control of 
the partition to the higher priority task. 


@e A task reguires a subpartition of the user-controlled main 
partition and a lower priority task occupies the main 
partition or the subpartition into which the task is to be 
loaded. Furthermore, the occupying task must be 
checkpointable and have checkpointing enabled. If all these 
conditions are met, the Executive checkpoints the task that 
occupies the partition and gives control of the subpartition 
to the higher priority task. 
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2.2.1.2 Checkpointing in System-controlled Partitions - Checkpointing 
in a system-controlled partition occurs as the result of a memory 
allocation failure. That is, the Executive tries to allocate a 
continuous section of a system-controlled partition to a task and it 
cannot find an unoccupied memory area of sufficient size. In this 
case, the Executive re-examines the list of allocated areas in the 
partition to determine whether it can form a free space of sufficient 
size by checkpointing one or more neighboring tasks. As with 
user-controlled partitions, each task considered for checkpointing 
must be of a lower priority, it must be checkpointable, and it must 
have checkpointing enabled. 


The Executive scans the list of allocated areas in the partition 
looking for a series of neighboring tasks, possibly separated by gaps 
of free space, where each task satisfies the checkpoint criteria. T£ 
the sum of the memory occupied by such a series of tasks and gaps 
satisfies the memory requirement for the higher priority task, the 
tasks are checkpointed and the higher priority task is allocated the 
released memory. If such a series of neighboring tasks cannot be 
found and memory compaction was generated for the system, the 
Executive calls the Shuffler task to try to bring in the highest 
priority waiting task. The Shuffler does this by compacting memory 
and checkpointing a sufficient number of lower priority tasks that are 
not necessarily neighbors in the partition. 


The checkpointing algorithm does have a limitation, however. If a 
large task is checkpointed and memory becomes fragmented by some 
smaller higher priority tasks, the smaller tasks block the large task 
from executing. The larger task can continue to be blocked until 
memory becomes free again by tasks exiting or being shuffled. 


2.2.1.3 Checkpointing During Terminal Input Wait - Checkpointing 
during terminal input wait, a SYSGEN option, allows checkpointable 
tasks to be checkpointed while they are waiting for terminal input. 
This feature allows more copies of terminal I/O-bound tasks (for 
example, text editors) to run than normally could be run in a given 
amount of memory. This option frees memory for the long time periods 
while a user is thinking or between keystrokes. This is important for 
text editors that normally run at a high priority. 


When the terminal driver dequeves a terminal input request for a 
checkpointable task that has checkpointing enabled, is not at AST 
state, and has ASTs enabled, the task is stopped from further 
execution. Thus, even if the task has not entered a wait state for 
the terminal input, its execution immediately stops when the request 
is degqueued by the terminal driver. 


When a task is stopped in this manner, its effective priority within 
its partition drops to zero. (Its actual priority never changes.) 
Therefore, lower priority tasks ready to run can cause a higher 
priority task that is waiting for terminal input to be checkpointed. 
When the terminal input to the checkpointed higher-priority task is 
completed, the Executive removes the stop condition and the task can 
be brought back into memory. If necessary, the Executive displaces 
lower priority tasks to make room for it. 


Normally, a task that was checkpointed for terminal input is not 
brought back into memory until its terminal request is satisfied. 
This is true even if memory becomes available during the wait. The 
only way the task can execute further, prior to the completion of the 
terminal input, is to receive an AST. 
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2.2.2 Disk Swapping 


Disk swapping allows more tasks of equal priority to alternate the use 
of memory into which they cannot be loaded simultaneously. Swapping 
is accomplished by varying task priorities so that tasks of the same 
priority checkpoint each other periodically. Checkpointing is the 
only Executive feature required for swapping to operate. 


Swapping does not affect the basic checkpointing algorithm as 
described under Checkpointing. For example, a task can only 
checkpoint another task of lower priority, never one of equal or 
higher priority. However, when swapping is enabled, the priority of 
tasks resident in memory varies with time (the installed priority of 
tasks remains unchanged - the swapping priority is for swapping only). 
The task's priority with respect to all of the other system resources 
does not change. 


Two SYSGEN parameters control the swapping algorithm: 


e Swapping interval. This parameter (SSSWPC) determines how 
often the Executive scans the partition lists to modify the 
swapping priority of resident tasks. A typical swapping 
interval might be about one-half second and is entered during 
SYSGEN as 30 (for 30 ticks or one-half second). 


e Swapping priority range. This parameter (SSSWPR) is’ the 
absolute value of the range through which a task's priority 
varies from its installed priority. A typical value is 5. 
This value would cause a task's memory priority to vary from 
P+5 to P-5, where P is the priority set for the task when it 
was installed. The installed priority is in the word, LSBPRI, 
in the task image label block. The swapping priority is in 
the byte, H.SPRI, in the task header. 


The key element of the swapping algorithm is the H.SPRI byte in the 
task's header, which is that task's swapping priority. The symbol, 
SSSWPR, is equated to the swapping priority range that is specified 
during SYSGEN. In a swapping system, each time a task is read into 
memory as the result of an initial task load or checkpoint read, the 
swapping priority byte in the task header is initialized to +SSSWPR 
(yielding a memory priority of the running priority plus the swapping 
priority). On the occurrence of each swapping interval, the swapping 
priority of each resident task is reduced by one until it reaches 
~SSSWPR (yielding a memory priority of the running priority minus the 
Swapping priority). The Executive determines whether a nonresident 
task should checkpoint a resident task by comparing the running 
priority of the nonresident task with the sum of the running and 
Swapping priorities of the resident task. If a possibility exists 
that checkpointing within a main partition might occur based on the 
new priorities, the Executive executes its partition allocation 
algorithm for that main partition. 


The following points should be considered when specifying swapping 
parameters: 


e The swapping interval should be approximately five times the 
round-robin scheduling interval. Round-robin scheduling is a 
SYSGEN option that periodically rotates the execution of tasks 
of equal priority that are in the System Task Directory (STD). 


e From the time a task is loaded into memory, the average time 
(in clock ticks - 1 tick=1/60 of a second for a line frequency 
clock (1/50 of a second for 50 cycle machines) it takes for a 
task of the same running priority to checkpoint it is roughly 
egual to the product of the two swapping parameters. 
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@ Tasks of the same running priority tend to get the same amount 
of time in memory. Tasks whose running priorities differ by 
less than the swapping range tend to receive different amounts 
of time in memory with the higher priority tasks getting much 
more time. When many tasks compete for memory and they are of 
different priorities, excessive checkpointing can occur. 
Therefore, tasks that use the swapping algorithm should have 
the same priority. 


e In a system that supports checkpointing during terminal input, 
terminal input is also a factor in causing checkpointing to 
occur. Editors and other interactive tasks normally should 
run at a higher priority than more compute-bound tasks. The 
higher priority increases’ the terminal response time. 
Otherwise, the editor would have to compete with other tasks 
(for example, utilities) most of which run at a priority of 
50. However, when an editor is waiting for terminal input, 
any lower priority task can checkpoint it. As soon as its 
input is complete, the editor can come back into memory by 
checkpointing the lower priority task. It is possible in a 
highly interactive system for the naturally high checkpoint 
rate to eliminate the need for the Executive swapping code to 
service many tasks of equal priority. 


2.2.3 Shuffler (Memory Compaction) 


SNXTSK, which is an Executive routine, attempts to find space in a 
partition for each waiting task. SNXTSK requests the Shuffler task 
after an allocation failure within the system-controlled partition 
takes place. The Shuffler receives no information from the Executive 
when it begins execution; it merely begins examining the partitions 
in the system starting from the beginning each time it is run. When 
the Shuffler encounters a system-controlled partition, the Shuffler 
makes two passes through the PCB list of subpartitions in an attempt 
to make room for the task or tasks in the main partition wait queue. 
In its first pass, the Shuffler attempts to remove all the holes in 
the partition. In addition, tasks that are stopped for terminal input 
are unconditionally checkpointed, if checkpointing during terminal 
input is included (a SYSGEN option). 


Tasks that have been fixed in memory can be shuffled. However, the 
following occupants of a system-controlled partition cannot. be 
Shuffled. For this reason, these memory residents cause free space to 
be fragmented in the partition. 


@ Loaded device drivers 

e Tasks that are connected to the ICS/ICR-11 or UDC-11 drivers 

@e A task whose partition was previously marked by the Shuffler 
as having a long outstanding I/O and whose I/O count has yet 
to drop to zero. Typical examples of this case are: 
- Tasks that issued terminal reads and cannot be checkpointed 
- LPA11 or tasks that have synchronous’ functions being 

serviced 

~ Tasks using the Connect to Interrupt Vector directive 


® Tasks that have been aborted and fixed by the Executive 
because of a memory parity error 


@ Dynamically-created common regions 
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When such a partition is encountered, the Shuffler treats the start of 
the subpartition as the end of an area within the main 
system-controlled partition. It treats each area as though it were a 
separate main partition. The tasks that occupy an area are shuffled 
until only one hole remains in the area. 


In its second pass, the Shuffler creates a list of all the tasks that 
occupy an area of the main partition. This list is in reverse 
priority order. The Shuffler then examines this list in an attempt to 
find tasks that the waiting task can checkpoint. The Executive 
routine ($TSTCP) determines if the waiting task can checkpoint the 
task that owns the partition, which is the “owner task". If this scan 
of the list indicates that the sum of space available from holes and 
checkpointable tasks is sufficient for the waiting task, the Shuffler 
scans the list a second time to checkpoint (using SICHKP) as many 
owner tasks as necessary. 


To shuffle a task, the Shuffler first "freezes" the task in memory to 
prevent it from being checkpointed. Then, using the Executive 
routine, SBLXIO, it moves the task image in the partition. The 
Shuffler executes this move while in system state (thus preventing 
context switching) and it does the move in 256.-word blocks. 
Therefore, QIO speed optimizations with a large BLXIO transfer vector, 
a SYSGEN option, increases the response time for a very high priority 
real-time task. 


The Shuffler's algorithm consists of two passes through the 
system-controlled partition; it executes the steps in each pass 
iteratively until the partition reaches a stable state. 


2.2.3.1 The Shuffler's First Pass - In the first pass, the Shuffler 
starts at the beginning of the system-controlled partition and tries 
to move (shuffle) all tasks that are positioned above a gap of free 
space down to the base of the free space. When possible, it also 
checkpoints any tasks it encounters that are waiting for terminal 
input. Task shuffling occurs in the following steps: 


e The Shuffler blocks the task from further execution and 
allocates the free space below the task. 


@e If necessary, the Shuffler waits for the task's outstanding 
I/O count to reach zero by checking it at intervals of 
approximately one-eighth of a second. If the task I/O count 
does not drop to zero in about one-half of a second, the 
Shuffler marks the task's partition as having long-outstanding 
I/O, deallocates the free space below the task, and restarts 
its first pass scan of the partition. The Executive clears 
the task's partition long-outstanding I/O indicator when it 
reduces the task's I/O count to zero. 


e If the task's I/O count drops to zero within one-half of a 
second, the Shuffler moves the task down to the base of the 
free space. The speed of this move increases if the QIO speed 
optimizations were included during phase 1 of SYSGEN and a 
large BLXIO transfer vector was allocated. 


e After the Shuffler completes the move, it unblocks the task to 
allow further execution and then it deallocates free space 
(now above the task). 
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When the Shuffler completes its first pass, all free space in the 
partition has been merged into one hole at the top of the partition. 
However, there may be additional holes below those tasks that cannot 
be shuffled. 


2.2.3.2 The Shuffler's Second Pass - If the Shuffler completes its 
first pass and some tasks are still actively competing for memory in 
the partition, the Shuffler executes its second pass algorithm. In 
the second pass, the Shuffler creates an ascending, priority-ordered 
list of the tasks in the partition. It then uses this list to 
determine if the size of the waiting task is less than the sum of the 
free space in the partition and the size of one or more of the lower 
priority tasks that can be checkpointed. If the waiting task's size 
is less than this sum, the lower priority tasks are checkpointed. The 
Shuffler then restarts its first-pass algorithm to accumulate the 
freed-up space and allocate it to the waiting task. If tasks that 
cannot be shuffled fragment the system-controlled partition, the 
Shuffler executes the second-pass algorithm once for each fragment of 
the partition. 


The RSX-11M philosophy of checkpointing in system-controlled 
partitions avoids preempting memory unless it can actually be used. 
When the Shuffler is active but not actually executing - for example, 
waiting for task I/O or a checkpointing operation to complete - it 
places itself in a state in which it may be checkpointed by any task. 
No lower priority task is checkpointed unless it is known beforehand 
that enough continuous space can be made available to load the higher 
priority task. The one exception is a checkpointable task waiting for 
terminal input. This task is swapped out unconditionally to make room 
for other tasks whenever the Shuffler is activated. It is not brought 
back in until the terminal input request is completed. 


If the Shuffler completes its second pass without finding space for 
the waiting task, it searches for the next system-controlled partition 
in the system and exits if none exists. 


2.2.4 The Loader (the System Loader Task) 


The Loader, which is a resident RSX-l11M system task, has’ three 
functions: 


l. Reading a task, which is either about to start executing or 
is being fixed, into memory 


2. Performing a checkpoint write of a task image from memory to 
disk : 


3. Performing a checkpoint read of a task image from disk into 
Memory (resuming checkpointed tasks) 


The Loader has the single objective of emptying its receive gueue of 
tasks waiting for its attention. 


The Loader's receive gueue, which consists of a list of TCBs, is 
ordered by priority. When SNXTSK or one of its associated routines 
determines that action by the Loader is reguired, the TCB of the’ task 
to be moved to or from the disk is placed in the Loader's receive 
queue and the Executive requests Loader execution. After it has begun 
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executing, the Loader examines two bits in the task status word of 
each TCB: the swap bit and the out-of-memory bit. These bits 
determine the Loader's action. The interpretation of these bits is as 
follows: 


Swap Bit Out-of-Memory Bit Action 
(TS .CKP) (TS .OUT) 
1 1 The task is read back into 
memory from its checkpoint area. 
1 
0 


The task is written from memory 
into its checkpoint area. 


So 


1 The task is read into memory 
from its load image. 


0 Illegal combination 


When the Loader removes the next entry from its gueue, it assumes 
Memory is available if the task is about to be read (it has been 
allocated by SNXTSK). After the Loader writes a task into its swap 
area, it calls the release partition routine that in turn calls SNXTSK 
to select the next task that will occupy the partition. 


The Loader performs several other functions associated with moving 
tasks to and from disk. These tasks include: 


Task Load and Checkpoint Read 
e Copy the task header into the Dynamic Storage Region 
e Initialize task swapping priority 
® Declare receive and receive-by-reference ASTs for the task if 
the appropriate gueues are not empty 
Checkpoint Read Only 


@ Release space held by the task within a dynamic checkpoint 
space file 


Task Load Only 
e Map the task's address windows to the task image and attach 
static commons 
Checkpoint Write Only 


@ Deallocate the Dynamic Storage Region copy of the task's 
header 


@ Place the task's TCB in the partition wait gueue 


@e Release the partition previously owned by the _ task. This 
results in a call to SNXTSK to reallocate the partition. 
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2.2.5 The S$NXTSK Routine 


SNXTSK is a routine in the Executive module, REQSB. S$NXTSK works with 
both user- and system-controlled partitions and takes a single input: 
the PCB address of the partition to be reallocated. SNXTSK examines 
all the TCBs in the partition wait gueue of the specified PCB and 
attempts to find space in the partition for each waiting task. When 
all TCBs in the gueue have been examined, a return to the caller is 
executed. . 


SNXTSK is called by routines that need partitions; it assigns a 
partition to the highest priority task waiting to occupy the 
partition. 


The inputs and functions of SNXTSK are listed in the following text. 


2.2.5.1 $NXTSK Inputs - The only input to SNXTSK is the address, 
which is in register 0, of the PCB of the partition to assign. 


2.2.5.2 S$NXTSK Functions - $NXTSK has five possible functions: 


1. The partition is not currently busy and a task is waiting to 
occupy the partition. SNXTSK assigns the partition to the 
waiting task and places a request on the Loader queue to load 
the task. 


2. The partition is currently occupied by a task that is either 
of higher priority than all the waiting tasks or is not 
checkpointable. In this situation, S$NXTSK cannot assign the 
partition to another task. 


3. The partition is currently occupied by a lower priority 
-‘checkpointable task. SNXTSK places a request in the Loader 
queue to checkpoint the task that owns the partition. 


4. The highest priority task waiting to occupy the partition 
needs the main partition that is currently occupied by one or 
more tasks that are either of higher priority or are not 
checkpointable. In this situation, $NXTSK cannot assign the 
partition to another task. 


5. The highest priority task waiting to occupy the partition 
requires the main partition that is currently occupied by one 
or more checkpointable tasks of lower priority. SNXTSK 
places a request in the Loader queue to checkpoint each task. 


2.2.5.3 $NXTSK Operation in a User-controlled Partition - If the 
partition being reallocated is a task partition, SNXTSK first 
determines if the requested space in the partition is unused, If it 
is, the task is assigned the space and a request to read the task into 
memory is issued to the Loader. 


If the space is being used by another task, SNXTSK calls S$TSTCP to 
determine if the task or tasks occupying the partition can be 
checkpointed by the reguesting task. If the task or tasks can be 
checkpointed by the requesting task and if checkpointing will produce 
enough space for the reguesting task, SNXTSK calls S$ICHKP to initiate 
a checkpoint of the task or tasks that occupy the space. 
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When the Loader completes the checkpoint write of the tasks that 
occupy the partition, it calls SNXTSK again to allow the requesting 
task to find the newly vacated space in the partition. 


2.2.5.4 $NXTSK Operation in a System-controlled Partition - If the 
partition being reallocated is a system-controlled partition, SNXTSK 
calls $FNDSP to find a-hole in the partition large enough for the 
requesting task. If such a hole is found, $NXTSK assigns to the 
requesting task as much of the Space in the hole as it requires, and 
issues a reguest to the Loader to read the task into memory. 


If S$NXTSK cannot find a satisfactory hole, it searches for a 
contiquous combination of holes and checkpointable tasks large enough 
to form a single hole large enough for the requesting task. SNXTSK 
calls S$TSTCP to determine if the memory resident task or tasks can be 
checkpointed by the reguesting task. If such a combination is found, 
SNXTSK calls SICHKP to initiate a checkpoint of each task in the 
potential hole. S$NXTSK then returns to the caller, relying on _ the 
Loader to call it again when checkpointing is complete. 


Finally, if no combination of contiguous holes and checkpointable 
tasks can be found, and if the Shuffler is installed, S$NXTSK reguests 
execution of the Shuffler. 


2.2.6 Routines That Call SNXTSK 


Examining the routines that call S$NXTSK yields information on _ the 
circumstances under which reallocation of a partition occurs. Figure 
2-2 shows that such routines tend to fall into two groups. Routines 
in the first group call $NXTSK directly (1 through 5 and A through G 
in Figure 2-2). Routines in the second group call routines A’ through 
G. Whe numbers and letters in Figure 2~2 are an index into a table of 
short routine descriptions that follow the Figure. 
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1OSUB 
1OSUB 6] SIOALT 
SIODON 


DRATX DREIF SSTSR SYSXT 


DREIF DRMAP DRRAS LOADR TDSCH 


16} $OREXT 17} S$ORSRF 18] $ORSND | 19] $LOADR 20] $CKINT 
DREIF DRREG LOADR LOADR 
22} $DREXT 231 $DETRG 241 $LOADR 261 SLOADR 
DRREQ ERROR REQSB TOSCH 
28{ $DRREQ 30} $EXROP $CKINT 
$EXROF 
$EXRON 
REQSB 
A | $A8TSK 
B | $ABCTK 
c | SDASTT 
$SOASTT 
fet 
REQSB 
$RLPR1 . 
$NXTSK 
$STPCT 
F | $TSKRT 
$TSKRP 
$TSKRAQ 
G 


Figure 2-2 Routines That Call SNXTSK 
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2.2.6.1 Routine Description - The numbers’ and letters in the 
following text are keyed to the numbers and letters in Figure 2-2. 


l. 


2. 


$DRATX - DRATX Module - AST exit directive 
Calls SNXTSK if task is stopped at task state. 


SDRECP - DRECP Module - Enable Checkpointing directive 
Calls SNXTSK when checkpointable task enables checkpointing 


SDREXP - DREXP Module - Extend Task directive 
Returns to S$NXTSK to reallocate the partition after changing 
the P.SIZE word in the task's PCB. 


$DRATP - DRRES Module - Alter Task Priority directive 
Calls $SNXTSK to reallocate the partition due to changed task 
priority. 


SIOFIN - IOSUB Module - I/O finish 

Calls S$NXTSK after completion of what has previously been 
declared a long--outstanding I/0. An I/0 operation is 
declared a long I/O by the Shuffler if the SEereteoe does not 
finish in 1/2 second. 


Routine that calls SIOFIN: 


6. $IODON/SIOALT - IOSUB Module - I/O done 
Calls SIOFIN unconditionally. Most drivers call SIOALT, 
SIODON, or S$IOFIN. 


SABTSK - REQSB Module - Abort task by TCB address 
Calls S$NXTSK after the task has been marked for abort. 


Routines that call $ABTSK: 


8. SDRABO - DRABO Module - Abort Task directive 
Calls SABTSK to actually abort the task. 


9. $LOADR - LOADR Module - Task Loader 
Calls SABTSK if a disk read error occurred while reading 
task. 


SABCTK - REQSB Module ~ Abort current task 
Calls SABTSK to abort task. 


Routines that call SABCTK: 


11. SDRATX - DRATX Module - AST Exit directive 
Calls SABCTK when address check of task stack fails; 
SABCTK aborts the task and the next AST is not acted 
upon. 


12. SDREXT - DREIF Module - Exit directive 
Calls SABCTK if task is already marked for abort. 


13. SSTXT - SSTSR Module - Common SST processing routine 
Calls SABCTK if task has no SST vector. 


14. SDIRXT - SYSXT Module - Directive exit (context switch) 
Call SABCTK if address check of task fails. 


SDASTT/SQASTT - REQSB Module - Declare or Queue (non-I/O) AST 
to task. 
SQASTT calls $NXTSK if task is not stopped; SDASTT calls 
SOQASTT. 
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Routines that call SDASTT: 


16. SDREXT - DREIF Module - Exit directive 
Calls S$DASTT to act upon floating-point, powerfail, and 
receive ASTs on task exit. 


17. SDRSRF. - DRMAP Module - Send-by-Reference directive 
Calls SDASTT to act upon receive-by-reference AST for 
receiver. - 


18. SDRSND - DRRAS Module - Send Data directive 
Calls SDASTT to act upon receive AST for receiver. 


19. SLOADR - LOADR Module - Task loader 
Calls $DASTT for receive and receive-by-reference ASTs if 
task queues are not empty when task is brought into 
memory. 


Routine that calls SQASTT: 


20. SCKINT - TDSCH Module - Clock interrupt service routine 
Calls SQASTT when mark time request has expired. 


SRLPAR/SRLPR1 - REQSB Module - Release partition 
Calls SNXTSK to allow next highest priority task to occupy 
partition. 


Routines that call SRLPAR/SRLPRI: 


22. DREXT - DREIF Module - Exit directive 
Calls SRLPAR when task exit is complete. 


23. SDETRG - DRREG Module - Detach Region directive 
Calls $RLPR1 when a dynamic common regiun with a "delete 
on last detach" attribute is detached by the last task 
and is deallocated from a system-controlled partition. 


24. SLOADR - LOADR Module - Task loader 
Calls $RLPAR upon completion of a checkpoint write of a 
task. 


SSTPCT/SSTPTK - REQSB Module ~ Stop (current) task 
Calls S$NXTSK after setting task's stop bit. 


Routine that calls SSTPCT/SSTPTK: 


26. S$LOADR - LOADR Module - Task loader 
Calls $STPCT to set its own stop bit when waiting for 
work. 
Note: Many privileged system tasks call $SSTPCT. 


STSKRT/STSKRP/STSKRQ - REGSB Module - Request task execution 
Calls SNXTSK to force reallocation of task's partition, if 
task is not fixed or active. 

Routines that call $STSKRT/$TSKRP/STSKRQ 


28. SDRREQ - DRREQ Module - Task Reguest directive 
Calls STSKRP to request desired task. 


29. SQEMB -—- ERROR Module - Queue error message block 
Calls STSKRT to request error logger to run. 
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30. SEXROQP/SEXROF/SEXRQON - REQSB Module - Execute task 
request 
Calls S$TSKRT after clearing task's stop bit on internal 
executive request of task (TKTN, LOADR, etc). 


31. SCKINT - TDSCH Module - Clock interrupt service routines 
Calls STSKRT to carry out a schedule request after a 
clock gueue has expired. 


G. SWAP - TDSCH Module - Disk swapping algorithm 
Calls $NXTSK during scan of all partitions in system. SNXTSK 
is called: 


@ Whenever a system-controlled partition is encountered 


@® Whenever the swapping priority of a task is reduced 


2.2.7 Routines That SNXTSK Calls 


2.2.7.1 SCHKPT Routine - SCHKPT checkpoints a task. When an Executive 
routine calls SCHKPT, all the conditions necessary for a task to be 
checkpointable have been met. If dynamic allocation of checkpoint 
space has been selected as a SYSGEN option, $CHKPT searches the 
checkpoint files for available space by using the SFNDSP routine. If 
this search fails, or if dynamic allocation of checkpoint space was 
not a selected option, $CHKPT determines if checkpoint space is 
allocated within the task's disk image file. If checkpoint space is 
found in either the dynamic checkpoint space or the task image file, 
SCHKPT issues a checkpoint request to the Loader and requests 
execution of the Loader. 


If no checkpoint space can be found, $CHKPT requests the TKTN task to 
print a message that so informs the user. 


The method used by the Executive to allocate space within the 
checkpoint file is identical to the method used to allocate space 
within a system-controlled partition. In both cases, a main PCB 
describes the overall area of allocation (main partition or entire 
disk file) and a sub-PCB describes a single fragment of the area 
(sub-partition for the task or portion of the checkpoint file reserved 
for one task image). In addition, both algorithms use $FNDSP to find 
a hole of the reguired size within the area described by the main PCB. 


2.2.8 S$FNDSP Routine 


SFNDSP tries to find space in a PCB list in a_e system-controlled 
partition for a PCB. It searches through the list until it finds a 
large enough hole. If it finds a large enough hole, $FNDSP links’ the 
PCB into the list. If it does not find a hole, SFNDSP sets the C-bit 
before returning to the calling routine. 
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2.2.9 SICHKP Routine 


Other routines call SICHKP to begin the checkpointing process for a 
task that owns a partition. SICHKP has three possible functions: 


l. If the task is already being checkpointed, S$ICHKP immediately 
executes a return to the calling routine. 


2. If the task is being read into memory or has outstanding I/O, 
SICHKP marks the task for checkpointing. If the task is 
being read into memory, the Loader detects that the task is 
marked for checkpointing when the read is done and 
immediately checkpoints the task. If the task has I/0 
outstanding, S$IOFIN in the IOSUB module is entered when the 
I/O is complete. SIOFIN detects the checkpoint reguest and 
checkpoints the task. However, terminal I/O that has been 
buffered is not included in the I/O count of a task. 


3. If neither 1. nor 2. above are true, SICHKP calls $CHKPT to 
checkpoint the task. 


2.2.10 $TSTCP Routine 


Other routines call S$TSTCP to determine if a task that owns space in a 
partition (owner task) can be checkpointed by a task that is 
requesting space in the same partition (requesting task). There are 
two conditions that must be met before the requesting task can 
checkpoint the owner task. 


First, the owner task must be eligible for checkpointing. A task is 
eligible for checkpointing if: 


e It is neither fixed nor being fixed 
e It was taskbuilt or installed as checkpointable 
e It does not have checkpointing disabled 


The second condition for checkpointability is that the reguesting task 
must have a default priority higher than the effective priority of the 
owner task. Two factors may make the effective priority of a 
memory-resident task different from its default priority: 


1. Tasks that are stopped, or that are stopped for terminal 
input and do not’ have outstanding ASTs, have an effective 
priority of zero. 


2. Ina system that includes the disk swapping of equal or 
nearly equal priority tasks, the effective priority of a task 
that is in memory is the sum of its default priority (from 
the TCB) and its swapping priority (from the task header). 


If these two conditions are met, the calling routine is informed that 
the reguesting task can checkpoint the owner task. Note that the 
presence of outstanding I/0 belonging to the owner task is not 
detected by this routine. 
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2.3 MEMORY ALLOCATION FLOW DIAGRAMS 


Memory allocation within partitions is managed by two types of 
routines in RSX-11M. Routines in the first group detect the presence 
of conditions that indicate reallocation of space within a partition 
is necessary. 


Routines in the second group (headed by the SNXTSK routine) find or 
create space for a task within a partition, and load the task into 
that space. In other words, the first group of routines determines 
when memory allocation should take place and the second group of 
routines does the reallocation. 


This flow diagram section contains flow diagrams of S$NXTSK and_ the 
routines that it invokes. It also contains flow diagrams of the 
Loader, Shuffler, SALOCB, and $DEACB. 
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2.3.1 $ALCLK Logical Flow Diagram 


REFERENCES: 


SALCLK: 
ALLOCATES A CLOCK 
QUEUE BLOCK FOR A 
CLOCK QUEUE ENTRY. 


$SALPKT: 
ALLOCATES A BLOCK FOR 
A SEND OR 1/0 REQUEST 
QUEUE ENTRY. 


$SALCLK:: 
PICK UP LENGTH OF 
CLOCK BLOCK. 
SALPKT 


GET LENGTH OF 1!/O 
PACKET. 
10$ et eet ae ae Pry ie $ALOCB 
CALL $ALOCB. FIGURE 2-4 


IF BLOCK ALLOCATED, 
RETURN TO CALLER. 
OTHERWISE, TRAP TO SET 
DIRECTIVE STATUS 
(DRSTS). 


$ALOCB 
FIGURE 2-4 


Figure 2-3 SALCLK Logical Flow Diagram 
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2.3.2 $ALOCB Logical Flow Diagram 


REFERENCES: 


SYSCM, $CRAVL, $PKAVL 


$ALOCB BEGINS WITH A 
REFERENCE TO $CRAVL IN 
SYSCM. $CRAVL-2 CONTAINS 
A3 USED TO ROUNDA 
REQUEST UP TO THE NEXT 
4-BYTE BOUNDARY. (A 
REQUEST FOR 19. BYTES GETS 
12. BYTES.) SCRAVL IS THE 
LIST HEAD FOR THE LIST 

OF DYNAMIC FREE MEMORY 
BLOCKS. $CRAVL + 2 IS ZERO 
BECAUSE IT IS THE LENGTH 
OF THE FREE BLOCK REPRE- 
SENTED BY SCRAVL. THERE 
ARE TWO ENTRY POINTS: 
$ALOCB AND $ALOC1. $ALOCB 
MAKES USE OF PRE- 
ALLOCATION OF 1/0 PACKETS, 
A SYSGEN OPTION. $ALOC1 
ALLOCATES BLOCKS FROM 
DYNAMIC MEMORY OTHER 
THAN THAT POINTED TO BY 
SCRAVL 


$ALOCB:: 


o---------- $CRAVL 


POINT TO ALLOCATION 
MASK WORD ($CRAVL-2). 
ROUND TO NEXT 4-BYTE 
BOUNDARY. 


IS REQUEST @ LENGTH? 


5$ 
PART 2 


PART 2 


Figure 2-4 S$ALOCB Logical Flow Diagram (Part 1 of 2) 
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PART 1 


y REFERENCES: 


DOES REQUEST SIZE = 5S 
PREALLOCATED BLOCK? PART 2 


IF PRE-ALLOCATED BLOCK 
AVAILABLE: 
UNLINK PACKET, 
SUBTRACT ONE FROM 
NUMBER OF PACKETS, 
RETURN 


IF PRE-ALLOCATED BLOCK 
NOT AVAILABLE: 


POINT TO $CRAVL-2 


$ALOC1:: 


30$ 
ZERO LENGTH REQUEST? >, sea 
10S 
308 
LAST BLOCK? poeta 
| 108 
BLOCK BIG ENOUGH? Saas 


’ LINK BLOCK IN CHAIN. 


CALCULATE AND RECORD 
REMAINING SIZE. 


30$ 


RETURN TO CALLER 


Figure 2-4 $ALOCB Logical Flow Diagram (Part 2 of 2) 
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2.3.3 SCHKPT Logical Flow Diagram 


SCHKPT:: 


REFERENCES: 


eee ee — — ~_SAVNR 
APPENDIX 8: CO-ROUTINES 
USE SAVNRA CO-ROUTINE 


TO SAVE R4 AND R85. 


CLEAR CHECKPOINT ALLOCATICN T2.CAF, T.ST2 
FAILURE. $ALOCB, P.SIZE 


ATTEMPT TO ALLOCATE PCB. 


PCB ALLOCATED? PART 1 


~—-—-—----- $CFLPT 


ALLOCATION SUCCESSFUL. 
CALCULATE NUMBER 

OF BLOCKS NEEDED IN 
DYNAMIC CHECKPOINT 
FILE. 

POINT TO DYNAMIC 
CHECKPOINT FILE LISTHEAD 


10% 


ANOTHER CHECKPOINT 36$ 
FILE EXIST? PART 2 


SSS SS SSS $DEACB 
DEALLOCATE CHECKPOINT 
PCB. 
20$ 


—_-———-—-—--- T2.CAF, T.ST2 
SET DYNAMIC CHECKPOINT 
SPACE ALLOCATION FAILURE 


iN TASK’S TCB 


PART 2 


Figure 2-5 SCHKPT Logical Flow Diagram (Part 1 of 2) 
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PART 1 


REFERENCES: 


— «= «ow en aw oe == wo ae = — T3.CAL, T.ST3 
1S CHECKPOINT SPACE 


ALLOCATED WITHIN TASK’S 
DISK IMAGE FILE? 


REQUEST TKTN TO PRINT 
MESSAGE ABOUT ALLO- 
CATION FAILURE. 


$SEXRON 


25$ 


RETURN TO CALLER THROUGH 
SAVNR CO-ROUTINE. 
30$ 
ALLOCATION IN FILE 
TURNED OFF? 


CALL $FNDSP TO FIND 
OUT IF ENOUGH SPACE 
EXISTS TO CONTAIN 

IMAGE OF THIS TASK. 


SPACE IN FILE? 
50$ 
a lentinentien iene tention TS. CKP, T. STAT 
SET CHECKPOINT IN 
PROGRESS BIT 


10$ 
PART 1 


— a — ——— SFNDSP 


10$ 
PART 1 


=——— SS $LOADT 
PLACE TCB OF TASK TO BE $LDRPT 
CHECKPOINTED IN LOADER $EXROP 


QUEUE AND CALL LOADER 
VIA $LOADT AND 
$EXRQP 


Figure 2-5 SCHKPT Logical Flow Diagram (Part 2 of 2) 
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2.3.4 SDECLK-$DEPKT-$DEACB Logical Flow Diagram 


REFERENCES: 


$DECLK:: 
DEALLOCATES A CLOCK 
QUEUE BLOCK. 


$DEPKT:: 
DEALLOCATES A SEND 
OR 1/O REQUEST 
BLOCK. 


$DEACB:: 
DEALLOCATES A STOR- 
AGE BLOCK (PACKET) 
FROM A LIST OF PRE- 
ALLOCATED PACKETS 
FROM POOL SPACE. 
OPERATIONAL IF PRE- 
ALLOCATED 1/0 PACKETS 
ARE AVAILABLE (Q$$OPT 
OPTION IN SYSGEN). 
OTHERWISE, $DEAC1:: 
IS USED. 

$DEAC1:: 
DEALLOCATES A STORAGE 
BLOCK FROM DYNAMIC 
MEMORY OTHER THAN POOL 
SPACE. |F A LOWER OR 
HIGHER ADJACENT BLOCK 
IS FREE, THE BLOCKS ARE 
MERGED TO PRODUCE ONE 
FREE BLOCK. 


$DECLK:: 


meee ee C. LGTH, $DEACB 


PICK UP LENGTH OF 
CLOCK BLOCK. 
BRANCH TO $DEACB. 


$DEACB 
PART 2 


Figure 2-6 $DECLK-$DEPKT-SDEACB Logical Flow Diagram (Part 1 of 5) 


MEMORY RESOURCE ALLOCATION 


REFERENCES: 


$DEPKT:: 


PICK UP LENGTH OF 1/0 
PACKET. 


$DEACB:: 


-<—-—— = a wae em |, LGTH 


ee ee we oe ee em SCRAVL 


(SEE $CRAVL DISCUSSION IN 
$ALOCB LOGICAL FLOW DIAGRAM) 


POINT TO ALLOCATION 
MASK WORD ($CRAVL 
-2) 

ROUND LENGTH TO NEXT 
4-BYTE BOUNDARY. 


LENGTH = @? 
NO BLOCK TO RELEASE. 
| Rm a IL LGTH 
LENGTH = 1/0 PACKET LENGTH? : Sted 
PART 3 


MAXIMUM NUMBER OF 
PACKETS ALLOCATED? 


INCREMENT COUNT OF 
AVAILABLE PACKETS BY 1. 
LINK PACKET INTO LIST 
RETURN TO CALLER. 


Figure 2-6 $DECLK-S$DEPKT-S$DEACB Logical Flow Diagram (Part 2 of 5) 
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$DEAC1:: REFERENCES: 


ROUND LENGTH TC NEXT 
4-BYTE BOUNDARY. 


RETURN 


30$ 


SAVE ADDRESS OF LISTHEAD 
ON STACK (IF ERROR 
CHECKING, RSSDER, |S 
OPERATIONAL). 


40$ 


GET ADDRESS OF CURRENT 
BLOCK AND NEXT BLOCK. 


NEXT BLOCK @? 50$ 
(END OF CHAIN?) PART 3 


NEXT BLOCK ADDRESS 40$ 
HIGHER OR EQUAL? 


50$ 


NEXT BLOCK ADDRESS 
LOWER. ADD SIZE 

TO ADDRESS OF THIS 
BLOCK TO GET AODRESS 
OF POSSIBLE NEXT BLOCK. 


PART 4 


Figure 2-6 S$DECLK-SDEPKT-$DEACB Logical Flow Diagram (Part 3 of 5) 
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REFERENCES: 
—— em «CARRY STAT 


DEALLOCATION IN FRONT 
OF START OF FREE SPACE? 
DEALLOCATION PAST END 
OF EXEC POOL? 
56$ 
COMPARE CALCULATED ADDRESS 
TO ADDRESS OF NEXT BLOCK 
NEXT ADDRESS LOW? 
NEXT ADDRESS NOT EQUAL? 


ADDRESS OF NEXT FREE 
SPACE EQUALS END OF 
THIS BLOCK. MERGE 
BLOCKS AND ADJUST 
LINK. 


PART 5 


Figure 2-6 S$DECLK-SDEPKT-SDEACB Logical Flow Diagram (Part 4 of 5) 
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PART 4 


8 REFERENCES: 


COMPARE ADDRESS AND LENGTH 
OF PREVIOUS FREE BLOCK TO 
ADDRESS OF BLOCK BEING 
RELEASED. 


60$ 


ee —~———— #ACRAVL 
CRASH 


DEALLOCATION IN EXEC 
POOL? 


65$ 
IF BLOCK BEING 
RELEASED IS 
ADJACENT TO PREVIOUS 
BLOCK, MERGE BLOCKS 
AND ADJUST LINKS. 

70$ 


OTHERWISE, SET SIZE 

OF BLOCK BEING RELEASED. 
POP LISTHEAD ADDRESS 
OFF STACK. 


RETURN | 


iF NEXT ADORESS LOWER 
THAN SIZE OF BLOCK TO 
BE DEALLOCATED, NEXT 
BLOCK BETTER BE AT 
END OF LIST. 


END OF LIST? — HS» CRASH 


80$ 


96$ 


60$ 
PART 5 


Figure 2-6 SDECLK-S$DEPKT-$DEACB Logical Flow Diagram (Part 5 of 5) 
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2.3.5 S$FNDSP Logical Flow Diagram 


REFERENCES 


SFNDSP:: 


GET STARTING ADORESS 
OF MAIN PCB, HIGHEST 
ADDRESS IN LAST PARTITION. 


10$ 
GET ADDRESS OF NEXT 
PCB. 7 
NEXT PCB EXIST? 

CALCULATE SIZE OF HOLE. 

IS HOLE BIG ENOUGH? 
CALCULATE ADDRESS OF | 198  P-SIZE 
NEXT HOLE PART 1 


—-— = a am a ew a a ee a P. REL, P. SUB 


PART 1 


eet ee ~—— P. REL 
CALCULATE SIZE OF LAST HOLE. P. SIZE 
46$ 
PART 1 


HOLE BIG ENOUGH? 
30$ 


HOLE BIG ENOUGH WAS 
FOUND FOR REQUESTING 
TASK. LINK PCB INTO 
LIST. 


P. SUB 


RETURN TO CALLER. 
C-BIT = 1 IF HOLE 
NOT FOUND. 


Figure 2-7 $FNDSP Logical Flow Diagram (Part 1 of 1) 
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2.3.6 S$ICHKP Logical Flow Diagram 


REFERENCES: 
—~_—--—- ---- = TS.OUT, T.STAT 
IS TASK TO BE CHECKPOINTED 20% 
BEING READ INTO MEMORY? PART 1 
~~ eee ee TS.CKP, T.STAT 


IS THE TASK ALREADY 
BEING CHECKPOINTED? 


---—— — — — $SETCR 
SET A CONDITIONAL SCHEDULE 

REQUEST TO ALLOW NEXT 

TASK ON ACTIVE TASK LIST 

(ATL) TO RUN. 


DOES TASK BEING CHECK— 20$ 
POINTED HAVE 1/0 IN PROGRESS? PART 1 
JUMP TO SCHKPT TO CHECK- 
POINT TASK. 
20$ TS.CKR, T.STAT 
SET CHECKPOINT. REQUEST. | 


RETURN TO CALLING ROUTINE. | 


Figure 2-8 SICHKP Logical Flow Diagram (Part 1 of 1) 
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2.3.7 SNXTSK Logical Flow Diagram 


SNXTSK:: 


REFERENCES: 


GET PCB ADDRESS OF MAIN PARTITION 


TO BE REALLOCATED. 


10% 


eee SO PLWAIT 


FIND TCB ADDRESS OF FIRST TASK 


IN PARTITION WAIT QUEUE. 


208 


TCB FOUND? 160$ 
PART 7 


— — — ——— S— _TASTL 


TASK STOPPED WITHOUT PENDING 40$ 
ASTS? PART 3 
21$ 
‘us P.STAT 
SYSTEM-CONTROLLED PARTITION? ce sate 
Sas ed: ae eet ee’ | P'BUSY 
MAIN PARTITION BUSY? 50S 
PART 4 


GET REQUESTED SUB-PARTITION 


ADDRESS. 


PART 2 


Figure 2-9 SNXTSK Logical Flow Diagram (Part 1 of 7) 
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REFERENCES: 
—e ee ee ee ee P.BUSY 
iS REQUESTED SUB-PARTITION 308 
BUSY? PART 3 
eee P.WAIT 
REQUESTED SUB-PARTITION IS FREE. $QRMVT 
REMOVE TCB OF REQUESTED TASK T.PCB 
FROM PARTITION WAIT QUEUE. P.BUSY 
$LOADT 


SET PARTITION BUSY FLAG. 
PLACE TCB OF REQUESTED TASK 
IN LOADER QUEUE AND REQUEST 
LOADER. 


10$ 
PART 1 


CONTINUE TO SCAN PARTITION 
WAIT QUEUE. 


Figure 2-9 SNXTSK Logical Flow Diagram (Part 2 of 7) 


REFERENCES: 


30$ 


REQUESTED SUB-PARTITION IS BUSY. 


—-—---— —-— — P.BUSY 


WAS MAIN PARTITION REQUESTED? 


50$ 
PART 4 
_-— wo P.TCB 
DETERMINE IF OWNER TASK. CAN BE $TSTCP 
CHECKPOINTED. 
IF OWNER TASK CANNOT BE CHECK- 
POINTED: GO TO NEXT TASK IN 20$ 
PARTITION WAIT QUEUE AND PART 1 
CONTINUE CHECKING ALLOCATION. 
—-—--—----- $ICHKP 
CHECKPOINT OWNER TASK. 
40$ 
GO TO NEXT TASK IN PARTITION oie 
WAIT QUEUE AND CONTINUE PART’ 


CHECKING ALLOCATION. 


Figure 2-9 SNXTSK Logical Flow Diagram (Part 3 of 7) 
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MEMORY RESOURCE ALLOCATION 


50$ REFERENCES: 


MAIN PARTITION IS BUSY: LOCATE 
FIRST SUS-PARTITION. 


IF SUB-PARTITION IS BUSY: 


P.TCB 
CHECK IF OWNER TASK CAN BE alba 
CHECKPOINTED. 

1008 
INT 
TASK CHECKPOINTABLE? neds 
NEXT SUB-PARTITION EXIST? ce. eas 
KEEP CHECKING BUSY SUB- sTsTeP 
PARTITIONS AND CHECKPOINTABLE see 
TASKS. IF PARTITION BUSY AND pols 
CAN BE CLEARED OF TASKS nie 


OR PARTITIONS NOT BUSY, 
THE SPACE !S AVAILABLE. 


108 
PART 7 


Figure 2-9 $NXTSK Logical Flow Diagram (Part 4 of 7) 


110$ REFERENCES: 


RE-ALLOCATION OF SPACE IN 
A SYSTEM CONTROLLED PARTITION. 


me ee ee ae ee ce oe ee omee> TPB 


GET ADDRESS OF REQUESTING 
TASK’S TCB. 


-——— — — — — — SFNDSP 


FIND SPACE IN PARTITION FOR 
TASK. 


WAS SPACE FOUND? 
GO REQUEST LOADER TO LOAD 
TASK. 


160$ 
PART 6 


268 
PART 1 


Figure 2-9 SNXTSK Logical Flow Diagram (Part 5 of 7) 
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MEMORY RESOURCE ALLOCATION 


150$ ; REFERENCES: 


BEGIN SEARCH OF HOLES AND 
ADJACENT CHECKPOINTABLE 
TASKS LARGE ENOUGH FOR 
REQUESTED TASK. 


160$ 


mee — == PREL 


P.SUB 
GET PCB ADDRESS OF SUB-PARTITION P.TCB 
AT END OF HOLE. IF END OF HOLE, $SHFPT 
ALSO END OF SYSTEM CONTROLLED $SEXRON 


PARTITION, REQUEST EXECUTION 
OF SHUFFLER AND RETURN TO 

CALLER, OR RETURN TO CALLER 
IF SHUFFLER NOT PRESENT. 


SHUFFLER OR CALLING ROUTINE 
(RETURN THROUGH SAVNR) 


PS.COM 


165$ P.STAT 
PART 7 


SUB-PARTITION OWNED BY 
LOADED DRIVER OR DYNAMIC 


COMMON? 
OWNER TASK CHECKPOINTABLE? 1658 
PART 7 


-PART 7 


Figure 2-9 $NXTSK Logical Flow Diagram (Part 6 of 7) 
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MEMORY RESOURCE ALLOCATION 


165$ 


RESET SIZE AND STARTING ADDRESS 


OF HOLE AND SCAN PARTITION Used 
TAGAIN. 6 
170$ 

TASK 1S CHECKPOINTABLE. 

CALCULATE NEW HOLE SIZE. 

HOLE LARGE ENOUGH FOR 160$ 
REQUESTED TASK? PART 6 


A COMBINATION OF HOLES AND 
CHECKPOINTABLE TASKS WILL 
YIELD A BIG ENOUGH HOLE. 


RETURN 
THROUGH 
SAVNR 


REFERENCES: 


P.REL 
P.SIZE 


SICHKP 
P.SUB 
P.TCB 


Figure 2-9 SNXTSK Logical Flow Diagram (Part 7 of 7) 


MEMORY RESOURCE ALLOCATION 


2.3.8 $TSTCP Logical Flow Diagram 


$TSTCP REFERENCES: 


T.ST2 
IS TASK STOPPED OR STOPPED 5$ T.ASTL 
FOR TERMINAL INPUT AND WITH- PART 1 
OUT PENDING ASTs. 
—<—— = ee om SSSWPR, TS.CKP, 
5 TS.CKR, TS.OUT, 
4 T.STAT 
TASK IN MEMORY? PART 1 
——— ee  TOPCB, P.HOR, 
H.SPRI, T.PRI 


INCLUDE SWAPPING PRIORITY 

FROM TASK HEADER IN COMPUTA- 

TION OF EFFECTIVE PRIORITY OF TASK. 
4$ 


IS OWNER TASK PRIORITY LESS THAN 10$ 
REQUESTED TASK PRIORITY. PART 1 


OWNER TASK MAY BE CHECK- 
POINTED BY REQUESTED TASK. 


5$ 


— See ee ——— T2CKD, T2CHK, 
T2.FXD, T2HLT, 
T.ST2 


1S OWNER TASK CHECKPOINTABLE? 


(INSTALLED CHECKPOINTABLE, 10$ 
HAVE CHECKPOINTING ENABLED, PART 1 
IS NOT FIXED OR BEING FIXED.) 
208 
RETURN TO CALLING ROUTINE. | 
10$ 
TASK OWNING PARTITION NOT 20$ 
CHECKPOINTABLE SET C-BIT. PART 1 


Figure 2-10 S$TSTCP Logical Flow Diagram (Part 1 of 1) 


MEMORY RESOURCE ALLOCATION 


2.3.9 Loader Logical Plow Diagram 


REFERENCES: 
SLOADR:: ~— — — — — SSWSTK, $STKTCB, T.RCVL 
SWITCH TO SYSTEM STATE. $ORMVF 
GET NEXT TCB FROM LOADER QUEUE.. 
_-—— — — -$STPCT 


10$ — — — — — TS.OUT, TSTAT 
CHECKPOINT WRITE? E> 30$ 
PART 1 


—— eee eS -T.PCB, P.HDR, P.REL 


COPY TASK HEADER IMAGE T.OFF, KISAR6, H.WND 
IN DSR TO TASK HEADER IN W.BLVR, H.OSW, H.HDLN 
TASK. 
Sh ——t ee = LORTK, T.PCB, T.STAT 
RETURN TO TASK STATE. GET ID.RLB, LDRFC 


ADDRESS OF TASK TCB. ASSUME 
READ FUNCTION. 


— ae oe me = TS.OUT, IO.WLB, LDRFC 
IF CHECKPOINT WRITE, SET 
WRITE FUNCTION. 


505 ee ee 0 LDRBF, R.REL, P.SIZE, 


T.OFF, T.LBN, T.LOV 


SET STARTING ADDRESS OF 
TRANSFER. COMPUTE SIZE OF 
TRANSFER ALLOWING PLAS 

TASK SIZE TO BE GREATER 

THAN 32K. DETERMINE DEVICE 

TO BE USED IN TRANSFER. ASSUME 
TRANSFER DEVICE IS TASK’S LOAD 
DEVICE. 


PART 2 


Figure 2-11 Loader Logical Flow Diagram (Part 1 of 8) 


MEMORY RESOURCE ALLOCATION 


PART 1 


REFERENCES: 


_—— — —— — — — TS.CKP 


60S 


CHECKPOINT REQUEST? PART 2 


aa (IE 


HAS DYNAMIC CHECKPOINT 
SPACE ALLOCATION FAILURE 
OCCURRED FOR THIS TASK? 


— ee oe a eee ee eee —T2.CAF, T.ST2 


56$ 
PART 2 


ee ee TCP, P.REL, P.MAIN 


POINT TO CHECKPOINT PCB. 
SET RELATIVE BLOCK NUMBER 
IN FILE. SET LBN TO LBN OF 

CHECKPOINT FILE. 


56$ 


—— TT MXSZ 


CHECKPOINT SPACE IS IN TASK 
FILE. GET PARTITION SIZE AND 
CALCULATE STARTING LBN 

OF CHECKPOINT AREA. 


—— ee —_ —— SHEADR, H.LUN 


ASSIGN LOADER LUN1 TO TRANS- 
FER DEVICE. LOCK OUT INTERRUPTS 


—— — — ~— — —P.REL, TS.CKP 


GET PARTITION ADDRESS. 65$ 
CHECKPOINT REQUEST? PART 3 


PART 3 


Figure 2-11 Loader Logical Flow Diagram (Part 2 of 8) 
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MEMORY RESOURCE ALLOCATION 


PART 2 


ey REFERENCES: 


CALCULATE OFFSET TO TASK 
IMAGE. 


ew cae a one oe ene eee | OREN, UISARG 
DETERMINE TRANSFER SIZE. 


70$ 


EXECUTE 1/0. 


—— awe owe mm ome CARRY STAT 


TRANSFER FAILURE BECAUSE 75$ 
OF NO POOL SPACE. PART 3 


88S 
LAST TRANSFER? OR ERROR? apa 
65S 
F 
SUCCESSFUL TRANSFER LS PART 3 


75$ 


WAIT FOR SIGNIFICANT EVENT. 


80S 


ALLOW INTERRUPTS. SWITCH 
TO SYSTEM STATE. 


TASK IN MEMORY? 
IF NO, CHECKPOINT 
WRITE JUST COMPLETED. 


SUCCESSFUL WRITE? 


PART 4 


Figure 2-11 Loader Logical Flow Diagram (Part 3 of 8) 
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MEMORY RESOURCE ALLOCATION 


PART 3 


REFERENCES: 


— ee ee me = TS.OUT, SDEACB, 
SQINSP, S$RLPAR, 
P.WAIT, P.MAIN 


SET TASK OUT OF MEMORY 
DEALLOCATE DSR COPY OF TASK 
HEADER. INSERT TASK TCB IN 
PARTITION WAIT QUEUE. 

CALL S$RLPAR TO RELEASE 
PARTITION. 

DONE. 


90$ 


——— ee — — — T.NCWF, SHEADR, 
H.LUN, $DVMSG, 
TS.CKP, T.STAT 
SET CHECKPOINT WRITE FAILURE. 
GET LOADER HEADER POINTER. 
GET UCB ADDRESS OF WRITE 
ERROR. OUTPUT WRITE ERROR 


MESSAGE. 

= — —— — — — — = T2.CAF, T.ST2 
SPACE IN CHECKPOINT FILE $LOADR:: 
EXIST? PART 1 

96$ 


USE SAVNR TO SAVE R4 AND R65. 
DELINK CHECKPOINT PCB FROM 
CHECKPOINT FILE LIST. DEALLO- 
CATE CHECKPOINT PCB. 


{F CHECKPOINT FILE EMPTY 


. AND NO LONGER IN USE, $LOADR:: 
REQUEST TKTN TO PRINT PART 1 
“CHECKPOINT FILE NOW 
INACTIVE”. 


Figure 2-11 Loader Logical Flow Diagram (Part 4 of 8) 


MEMORY RESOURCE ALLOCATION 


REFERENCES: 


1198 ee ee ee we we P.REL, KISARG (MSSMGE): 


TASK READ OR CHECKPOINT T.OFF, KISAR6 (PS$LAS) 
READ JUST COMPLETED. 

MAP APR6 TO REAL TASK 
HEADER. 


120$ 
SUCCESSFUL READ? 
ureeo Ue PART 5 
15 

115$ Sept a aa a au met ee H.NLUN, W.BLGH 

SET NUMBER OF TASK LUNs 

TO ZERO. 
120$ — — — $ALOCB, $TKWSE 


ALLOCATE SPACE FOR TASK 
HEADER IN DSR. IF CANNOT 


BE DONE, WAIT FOR SIGNIFI- 
CANT EVENT AND RETURN TO 848. 


1308 pies cece Ne ane 
SAVE ADDRESS OF COPY OF 
HEADER IN TASK’S PCB. 


H.HDLN, H.GARD, H.WND, 
SET UP TO COPY TASK H.NLUN, 
HEADER FROM TASK TO 


DSR. 


140$ 


----- ——— TSTAT 
COPY TASK HEADER FROM 
TASK TO DSR. 
——---—---- TS.OUT 
CLEAR TASK OUT OF MEMORY BIT 
TO NOTE TASK IN MEMORY. 


PART 6 


Figure 2-11 Loader Logical Flow Diagram (Part 5 of 8) 
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MEMORY RESOURCE ALLOCATION 


PART 5 


GET TASK HEADER ADDRESS. 
INITIALIZE SWAPPING PRIORITY. 


REFERENCES: 
a sas tes ae — P.HDR, SSSWPR, H.SPRI 


-—-——_— = — — = H.WND, SMAPTK 


MAP TASK’S FIRST ADDRESS 
WINDOW. 


------ H.IPS, 10SB 
INVALID TASK IMAGE OR as 
READ ERROR? cue 
es fa Nn ae tall vt TS.CKP 
CHECKPOINT READ? > ‘eis 
PART 6 
— —- — — — — HWND, LDRBK, T.ATT, 
ATTACH-TASK TO STATIC COMMON AS.RED, W.BLPD, AS.WRT, 
REGIONS SPECIFIED AT TASK SCRATT, STKWSE, SSWSTK, 
BUILD. W.BATT 
149$ 
—— — — — — 7T2BFx, TST2 
IS TASK BEING FIXED IN MEMORY? ue 
PART 7 
—-—--—--- $BILDS 


BUILD A STACK FOR TASK JUST 
STARTING AND PLACE TASK ON 
ACTIVE TASK LIST. 


150$ 
CHECKPOINT READ COMPLETE. 
DEALLOCATE CHECKPOINT 


SPACE FROM CHECKPOINT FILLE. 
DEALLOCATE CHECKPOINT PCB. 


PART 7 


Figure 2-11 Loader Logical Flow Diagram (Part 6 of 8) 
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MEMORY RESOURCE ALLOCATION 


& REFERENCES: 


HAS A CHECKPOINT OF THE TASK ES 166$ 


165$ 


PART 7 


BEEN REQUESTED? 


GET ADDRESS OF TASK TCB. 
CHECKPOINT THE TASK. 


DOES TASK ALLOW SEND OR 169$ 
SEND-BY-REFERENCE? PART 7 


ee eT RCVE 


ANYTHING IN TASK’S RECEIVE 165$ 
QUEUE? PART 7 


ee —— H.RCVA, SDASTT 
DECLARE RECEIVE AST. 
ome a CRT swND en oe om | RREL 


ANYTHING IN RECEIVE-BY-REFERENCE QUEUE? eal ; 


DECLARE RECE!VE-BY-REFERENCE 
AST. 
RETURN-END OF LOADER 
RETURN TO $LOADR:: 


170$ ee ee we ee ee ee me BEX, T2.FXD 


TASK FIXED IN MEMORY. CLEAR BEING 
FIXED FLAG. SET TASK FIXED IN 
MEMORY FLAG. 


RETURN-END OF LOADER. 
RETURN TO $LOADR:: 


Figure 2-11 Loader Logical Flow Diagram (Part 7 of 8) 
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MEMORY RESOURCE ALLOCATION 


REFERENCES: 
Ro eg T2.BFX, TS.EXE 
TASK UNSUCCESSFULLY READ. 
CLEAR TASK BEING FIXED FLAG. 
NOTE TASK NOT IN EXECUTION. 
-———— ere — = UISDRG@, H.NUN, H.RRVA, 


H.FPSA, H.GARD, H.PFVA 


DO HOUSEKEEPING-CLEAR: 
ATTACHMENT DESCRIPTOR 
ADDRESS, 
NUMBER OF LUNs, 
RECEIVE-BY-REFERENCE 
CONTROL BLOCK ADORESS, 
FLOATING-POINT SAVE 
POINTER, 
RECEIVE CONTROL BLOCK 
POINTER, 
FLOATING-POINT CONTROL 
BLOCK POINTER, 
POWERFAIL CONTROL 
BLOCK POINTER. 


CHECKPOINT READ DONE? 


PLACE TASK ON ATL. 


187$ 


ee ee a ee TS.CKP, TS.CKR, S.CCRF 


NOTE CHECKPOINT READ 
FAILURE OCCURRED. 


-- ee $SABTSK 
ABORT TASK. | 


RETURN - LOADER DONE. 
RETURN TO $LOADR:: 


Figure 2-11 Loader Logical Flow Diagram (Part 8 of 8) 
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MEMORY RESOURCE ALLOCATION 


2.3.10 Shuffler Logical Flow Diagram 


oe ee ee ow eee SHUFFLER INITIALIZATION CODE - ALLOCATE 
PCB AND CLOCK BLOCK 


REFERENCES: 


$SWSTK 


$ALOCB 
P.LGTH, PCBAD 


ALLOCATE A CLOCK QUEUE 
BLOCK VIA CALL $ALOCB FOR 
MARK TIME REQUESTS. 

ALLOCATE A PCB. 


ALLOCATIONS SUCCESSFUL? E> $SHUFL:: 


DEALLOCATE POSSIBLE CLOCK 
QUEUE BLOCK. WAIT FOR 
SIGNIFICANT EVENT. 


$DECLK 
INITL: $TKWSE 


SSHUF L:: 


mee ea — — — SSWSTK 
SWITCH TO SYSTEM STATE $SHUFL 

(CALL $SWSTK, $SHUFL) CLEAR RQSCH, RQSCH1 
LOCAL SCHEDULE REQUEST 

FLAGS, 


START SCAN OF PARTITIONS 
IN SYSTEM. 


PART 2 


Figure 2~12 Shuffler Logical Flow Diagram (Part 1 of 11) 
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MEMORY RESOURCE ALLOCATION 


PART 1 
REFERENCES: 


PASS 1: 


ANY MORE PCBs? 


EXIT: 
PART 5 


en ae nme comme mm PS.SYS, P.STAT 
1S PARTITION SYSTEM CONTROLLED? PASS 1: 
PART 2 


_—— PIT 
TASKS IN PARTITION WAIT PASS 1: 
QUEUE? PART 2 
ee rise siz 
IS TASK STOPPED? ;H> yaa 
Se 
1 
| TASK HAVE QUEUED AST? =a aes 


=" TCBAD 
P.REL 
16$ THROUGH $40 CHECKS, SAVES, 
AND ADDS HOLE SIZES. IF PARTI- 
TION IS IMMOBILE, SHUFFLER SETS 
SCHEDULE REQUEST (LOCAL) AND 
CHECKS NEXT PCB. 


SAVE WAITING TCB ADDRESS. 
GET MAIN PARTITION PCB 

ADDRESS. GET BASE ADDRESS 
OF INITIAL HOLE. 


208 


————— —— P.suB 
| FIND PCB AT END OF HOLE, IF an | 


_— en eo (CHECK IF SECOND PASS 
PCB FOUND? PASS 2: 1S REQUIRED) 
PART 6 


PART 3 


Figure 2-12 Shufller Logical Flow Diagram (Part 2 of 11) 
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MEMORY RESOURCE ALLOCATION 


PART 2 


Sy REFERENCES: 


_— oOo sO _s~PS.COM, PS.NSF, PS.DRV, 
CHECK IF PARTITION CAN BE PS.LIO, P.STAT 
SHUFFLED. 

UNSHUFFLABLE: 

LIBRARY OR COMMON BLOCK, 

PARTITION MARKED NOT 


SHUFFLABLE, 
LOADED DRIVER, 
MARKED BY SHUFFLER 

FOR LONG 1/0. 


40$ 
SHUFFLABLE? ny PART 4 


= omneaeT> —— oe TS.CKR, TS.CKP, TS,OUT, 


CHECK IF OWNER TASK CAN BE 
SHUFFLED. 
IMMOBILE TASK: 


TASK CHECKPOINT REQUESTED, 
TASK BEING CHECKPOINTED, 
TASK OUT OF MEMORY. 


50$ 
TASK IMMOBILE? PART 4 
eee )6—RROSCH, P.REL, P.BLKS 
SET SCHEDULE REQUEST FOR THIS 
PARTITION (CHECK LATER). 


PART 4 


Figure 2-12 Shuffler Logical Flow Diagram (Part 3 of 11) 
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MEMORY RESOURCE ALLOCATION 


PART 3 


REFERENCES: 


—_——— oo —— — P.REL, P.BLKS 


CALCULATE BASE OF NEXT HOLE. 208 
PART 2 
50$ 
IS TASK CHECKPOINTABLE? 55$ 
PART 4 


— — — —— T2.sTP 
IS TASK STOPPED FOR TERMINAL 75$ 


1/0? PART 5 

oP REL 

IS SUBPARTITION AT BASE OF 

CURRENT HOLE (FROM 40$ 

OR 168). 40$ 

IF SO; NO NEED TO SHUFFLE PART 4 

OWNER TASK. IT’S REALLY 

NOT A HOLE. 
— —— —— — TSKST, T2.CKD, TS.CKP 


PCBAD, P.REL, P.BLKS, 
P.SUB, WAITCT, RETURN 


SAVE CURRENT TASK STATUS. 
FREEZE TASK IN MEMORY. 
GET ADDRESS OF DUMMY PCB 
(FROM INITL:). GET ADDRESS 
OF TASK PCB. 

COPY TASK PCB. 

LINK DUMMY PCB INTO PCB 


CHAIN. 

SET 5 IN WAIT COUNT FOR 

1/0. SHUFFL: 
PART 1 


RETURN TO USER STATE. 


Figure 2-12 Shuffler Logical Flow Diagram (Part 4 of 11) 
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MEMORY RESOURCE ALLOCATION 


REFERENCES: 


——— eee eee | TST 2, SCHKPT, ROSCH 


POINT TO TCB AND CALL $CHKPT 
TO CHECKPOINT OWNER TASK. 
SET LOCAL RESCHEDULE REQUEST 
FLAG, RQSCH, TO RECHECK THIS 
PARTITION LATER. 


END OF PCB SCAN. REMOVE SHUFFLER 
CLOCK QUEUE ENTRY IF ONE EXISTS. 


— cece ome sew ROSCH1 


WAS PARTITION SCHEDULED TO 
BE RECHECKED? 


— — ~-—— CLKAD, SDECLK, PCBAD 
P.LGTH, $0EACB, $DREXT 


CALL $DECLK TO DEALLOCATE 
SHUFFLER CLOCK BLOCK. 
DEALLOCATE DUMMY PCB. 
EXIT. 


MKTIM: 


_— a — =—C.CSTP, CLKAD, STKPS 
BUILD CLOCK QUEUE ENTRY FOR $CLINS, $STPCT 
1/8 SEC. WAIT. INSERT ENTRY IN 
CLOCK QUEUE, SHUFFLER STOPS 
ITSELF FOR 1/8 SECOND. 


RETURN TO $SHUFL:: 


Figure 2-12 Shuffler Logical Flow Diagram (Part 5 of 11) 
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PASS 2: 


At this point, if no reschedule request has been posted for this partition, the following conditions are valid: . 


There is at least one task in the wait queue. The Executive cannot fit the first one in by checkpointing neighboring tasks. 
The only place a hole can exist is before the end of a partition or before a partition that cannot be shuffled (hereinafter 
referred to as a driver partition). 

No tasks in the partition are in the process of baing checkpointed. 


The following code gets in the next waiting task by checkpointing lower priority tasks and shuffling. No tasks are 
checkpointed unless it is absolutely certain that by doing so the next waiting task will fit. This code refers to an area of the 
main partition, preceded by the beginning of the main partition or a driver partition and followed by a driver partition or 
the end of the main partition, as a section. 


The following code determines the number of lowest priority tasks in a section that can be checkpointed to allow the 
waiting task to fit. The Executive's task swapping algorithm is also included in this determination. 


The key to the swapping algorithm is the swapping priority byte in the task header (H.SPR!). This byte is initialized to 
+S$SWPR each time a task is read into memory and TDSCH decrements it periodically as the task resides in memory. The 
Executive routine, $TSTCP, adds the swapping priority to the priority byte in the TCB of the task in memory when 
determining if a nonresident task may checkpoint that task. In this pass, if there is a task that is not stopped in the wait 
queue of the current main system-controlled partition, the Shuffler forms.a linked list, one section at a time, of all tasks in 
that section by increasing priority (weighted by the swapping priority). As soon as the Shuffler forms this linked list, the 
priority bytes in the TCBs are reset to their original values. Traversing this list, the Shuffler accumulates the sizes of all 
tasks checkpointable by the waiting task until sufficient size is found or the Ist is exhausted. The Shuffler adds the 
accumulated size to the size of the hole at the end of the section. If enough space is found the task(s) are checkpointed. 


PART 7 


Figure 2-12 Shuffler Logical Flow Diagram (Part 6 of 11) 
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MEMORY RESOURCE ALLOCATION 


PART 6 


REFERENCES: 


—— 1 —ROSCH 


1S THIS PARTITION RESCHEDULED? 


GET ADDRESS OF WAITING TCB. 
START PCB LIST SCAN. 


POINT TO NEXT PCB. IF END OF PCB 
LIST, GO CHECK NEXT MAIN PCB, 


CLEAR AVAILABLE SPACE COUNTER. 
CLEAR REVERSE PRIORITY LISTHEAD. 


40$ PS.COM, PS.NSF, PS.DRY 


PS.LIO. P.STAT 
PARTITION SHUFFLABLE? 


POINT TO TASK HEADER AND 
TCB. ADD IN SWAPPING PRIORITY. 


— — —— — — —FPRIL 


POINT TO NEXT IN LIST. 42$ 
ANY MORE IN LIST? PART 8 


TASK IN PARTITION LOWER IN 41$ 
PRIORITY? PART 7 


PART 8 


Figure 2-12 Shuffler Logical Flow Diagram (Part 7 of 11) 


MEMORY RESOURCE ALLOCATION 


PART 7 


LINK PARTITION TASK INTO 
LOWER PRIORITY CHECK- 
POINT LIST. 


42$ 
REFERENCES: 


453 eee ee = — PUB, P.MAIN, P.SIZE 


40$ 
PART 7 


ANOTHER PCB EXIST? 


503 ee ee PP REL, P.MAIN, P.SIZE 


END OF AREA BOUNDED BY P.PRIL 
UNSHUFFLABLE SUBPARTI- 

TION OR END OF PARTITION HAS 
BEEN REACHED. PASS 1 OF 
SHUFFLER PLACED ONLY HOLE 
IN THIS AREA AT END OF AREA. 
COMPUTE HOLE SIZE. BEGIN 
SCAN OF REVERSE PRIORITY 
LIST. 


70$ 


GET NEXT TCB IN LIST. WAS 368 
ONE FOUND? PART 7 


ss i a oe a ae T.PCB, P.HDR, H.SPR! 
T.PRI, $TSTCP 


READ JUST TASK’S PRIORITY. 
CAN OWNER TASK ON THE RE- 
VERSE PRIORITY LIST BE 
CHECKPOINTED BY THE 
WAITING TASK? 


PART 9 


76$ 
PART 8 


Figure 2-12 Shuffler Logical Flow Diagram (Part 8 of 11) 


MEMORY RESOURCE ALLOCATION 


PART 8 


ee REFERENCES: 


—_—— — — —PSIZE 


ADD SIZE OF THIS CHECK- 


POINTABLE TASK TO THE 
SUM OF SPACE AVAILABLE. 


— = — — — — -T PCB, PSIZE 
70$ 
CAN WAITING TASK FIT? > eas 


_—-—— — — — RPRIL 


CHECKPOINTING THIS TASK WILL 
MAKE ENOUGH ROOM. SAVE 

POINTER TO THIS TCB. START RE- 
SCAN OF LIST. 


75$ 


— =—— — — — STSTCP 


a eee ee we [CHP 


ADJUST TASK PRIORITIES 
(SUBTRACT SWAPPING PRIORITY) 
OF REST OF TASKS IN LIST. 


Figure 2-12 Shuffler Logical Flow Diagram (Part 9 of 11) 


MEMORY RESOURCE ALLOCATION 


SHUFFL: REFERENCES: 


SWITCH TO SYSTEM STATE AND PCEAD, SSWSEG.P-1GE 
EXAMINE TASK TO BE SHUFFLED. 


ee —T.10C 
DOES TASK HAVE OUTSTANDING 139$ 
1/0? PART 10 
SET LOCAL NO-RELOCATIONFLAG. | tf _ == WAITET 
HAS SHUFFLER WAITED 1/2 SEC. 125$ 
FOR 1/0 TO FINISH? PART 10 
ae ROSCH1 
RESCHEDULE SHUFFLER AND RETURN EXIT: 
IN 1/8 SEC. RETURN TO 
SHUFEL: 
139$ 
RETURN TO TASK STATE. 
RETURN TO 1178. 
—— — — — — RREL, P.SUB, P.BLKS 
SET LIMITS OF TASK IMAGE MOVE. | 
120$ 
---- —— $SWSTK, $BLXIO 


SWITCH TO SYSTEM STATE. 
MOVE TASK IMAGE. CLEAR 
LOCAL NO-RELOCATION FLAG. 


125$ 


ee ee — P.MAIN, P.SUB 


135$ 
PART 11 


WAS SHUFFLE PERFORMED? 


ADJUST TASK PCB TO REFLECT 
SHUFFLE. 


PART 11 


Figure 2-12 Shuffler Logical Flow Diagram (Part 10 of 11) 


MEMORY RESOURCE ALLOCATION 
PART 16 


CLEAR CHECKPOINT IN PROGRESS. 
RESTORE TASK STATUS. 


IF 1/O STILL TO BE DONE, 
SET LONG 1/O BIT, 

RETURN TO USER STATE, 
GO TO $SHUFL 


REFERENCES: 


ae ee ee ee ee ome PS. LIO, PSSTAT 


IF 1/O NOT STILL TO BE DONE, 
GET ADDRESS OF MAIN 
PARTITION PCB AND 
CALL $NXTSK TO 

REALLOCATE PARTITION. 


$NXTSK:: 


Figure 2-12 Shuffler Logical Flow Diagram (Part 11 of 11) 


2.4 MEMORY ALLOCATION DATA STRUCTURES 


The two fundamental data structures that are used by the Executive 
during memory allocation are the Partition Control Block (PCB) and the 
Task Control Block (TCB). They are both included here for your 
reference while you follow the operations of the flow diagrams. 


2.4.1 Partition Control Block (PCB) 


The PCB serves three major functions in the memory allocation 
routines: 


1. The PCB contains the starting address and length of the main 
or subpartition it represents. 


2. The PCB of a main task partition or a system-controlled 
partition contains busy flags and is the listhead of a linked 
list of subpartition PCBs. This allows the Executive to 
determine the availability of space within a partition. 


3. The main partition PCB serves as the listhead for a linked 
list called the partition wait gueue. Tasks that are 
competing for space in the partition and are out of memory 
have their TCBs linked into this list. 


MEMORY RESOURCE ALLOCATION 


A partition or subpartition may be created in three ways: 
1. By a VMR or MCR Set command 
2. By the Executive in a system-controlled partition 


3. By the Loader task when loading a device driver into a 
system-controlled partition 


Whenever a partition is created, a PCB is allocated from the Dynamic 
Storage Region. The PCB is then filled with the starting address and 


length of the partition and is linked into the appropriate system 
lists. 


Partition Control Block, Figure 2-13, describes the fields contained 
in the Partition Control Block. 


MEMORY RESOURCE ALLOCATION 


PARTITION CONTROL BLOCK (PCB) 
P.LNK LINK TO NEXT PARTITION PCB. 


PRIORITY OF PARTITION; 1/0 AND 
1/0 STATUS BLOCK COUNT. 


PARTITION NAME IN RADS@. 


POINTER TO NEXT SUBPARTITION, 


P.MAIN POINTER TO MAIN PARTITION. 


POINTER TO HEADER CONTROL 
BLOCK (1F M$$MGE NOT DEFINED). 


STARTING PHYSICAL ADDRESS 
OF PARTITION. 


SIZE OF PARTITION IN BYTES. 


P.REL 
P.BLKS/P.SIZE 


P.WAIT PARTITION WAIT QUEUE LISTHEAD. 


PARTITION SWAP SIZE. 


P.BUSY (2 BYTES) PARTITION BUSY FLAGS. 


P.OWN/P.TCB TCB ADDRESS OF OWNER TASK. 


P.STAT PARTITION STATUS FLAGS. 


POINTER TO HEADER CONTROL BLOCK 
({F M$$MGE IS DEFINED). 

PROTECTION WORD FOR P$$LAS 
(DEWR, DEWR, DEWR, DEWR). 


ATTACHMENT DESCRIPTOR LIST HEAD 
(FOR P$$LAS). 


P,PRO 


P.ATT 


Figure 2-13 Partition Control Block (Part 1 of 2) 
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MEMORY RESOURCE ALLOCATION 


Partition Status Word Bit Definitions 


PS .OUT='B‘'100000 
PS.CKP='B' 40000 


PS.CKR='B'20000 
PS.CHK='B'10000 
PS.FXD='B' 4000 
PS.PER='B'2000 
PS.LIO='B'1000 
PS.NSF='B'400 
PS.COM='B'200 
PS.PIC='B'100 
PS.SYS='B'40 
PS.DRV='B' 20 
PS.DEL#='B'10 
PS.APR='B'7 
Attachment Descriptor Offsets 
A.PCBL:'L'.BLKW 1 


A.PRI:'L'.BLKB 1 
A.IOC:'L'.BLKB 1 


A.TCB:'L'.BLKW 1 
A.TCBL: 'L'.BLKW 1 


A.STAT:'L'.BLKB 1 
A.MPCT:'L'.BLKB 1 


A.PCB:'L'.BLKW 1 
A.LGTH: 'B'. 


Partition is out of memory 

Partition checkpoint in pro- 
gress 

Partition checkpoint is re- 
quested 

Partition is not checkpoint- 
able 

Partition is fixed 

Parity error in partition 

Marked by shuffler for long 
I/O 

Partition is not shufflable 
Library or common block 
Position independent li- 
brary or common 

System controlled partition 
Driver is loaded in partition 
Partition should be deleted 
when not attached 

Starting PAR number mask 


PCB attachement queue thread 
word 

Priority of attached task 
I/O count through this des- 
criptor 

TCB address of attached task 

TCB attachment queue thread 
word 

Status byte 

Mapping count of task through 
this descriptor 

PCB address of attached task 


Attachement Descriptor Status Byte Bit Definitions 


AS.DEL='B'10 
AS.EXT='B'4 
AS .WRT='B'2 
AS.RED='B'1l 


Task has delete access 
Task has extend access 
Task has write access 
Task has read access 


Figure 2-13 Partition Control Block (Part 2 of 2) 


MEMORY RESOURCE ALLOCATION 


2.4.2 Task Control Block (TCB) 


The TCB 
ee: 
25 


3. 


contains three major kinds of information: 
Links and listheads to other control blocks or queues 


Pointers related to task execution and needed by the 
Executive 


Three words of status information 


Other information includes: 


Figure 
Block. 


Task priority 

I/O pending count 

Task name 

Task local event flags 
Task default priority 


Task image size 


2-14, Task Control Block, describes’ the fields in the Task Control 


MEMORY RESOURCE ALLOCATION 


T.LNK 


T.CPCB 


UTILITY LINK WORD. 


TASK PRIORITY: 1/0 PENDING COUNT 


POINTER TO CHECKPOINT PCB* 


T.NAM 


T.RCVL 
T.ASTL 
T.EFLG 


TASK NAME IN RADS5@. 


RECEIVE QUEUE LISTHEAD. 


AST QUEUE LISTHEAD. 


TASK LOCAL EVENT FLAGS 


1-32. 
UCB ADDRESS FOR PSEUDO 
T.UCB DEVICE “TI” 


TASK LIST THREAD WORD. 
FIRST STATUS WORD (BLOCK- 


T.TCBL 
T.STAT 


ING BITS). 
(STATE BITS). 


THIRD STATUS WORD 
(ATTRIBUTE BITS). 


TASK’S DEFAULT PRIORITY. 


LBN OF TASK LOAD IMAGE. 


UCB ADDRESS OF LOAD DEVICE. 


PCB ADDRESS OF TASK PARTITION. 


MAXIMUM SIZE OF TASK IMAGE 
(MAPPED SYSTEM) 

ADDRESS OF NEXT TASK IN ACTIVE 
LIST. 

ATTACHMENT DESCRIPTOR 
LISTHEAD. 


OFFSET TO TASK IMAGE IN PARTITION. 


SREF WITH EFN COUNT IN ALL 


RESERVED RECEIVE QUEUES. 


RECEIVE BY REFERENCE LISTHEAD. 
*OR LINK TO ITBS FOR TASKS CONNECTED TO INTERRUPTS. 


Pigure 2-14 Task Control Block (Part 1 of 2) 
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MEMORY RESOURCE ALLOCATION 


Task Status Definitions (* = statement true when bit is on) 


First Status Word (Blocking Bits) 


TS.EXE='B'100000 Task not in execution * 

TS.RDN='B' 40000 I/O run down in progress * 

TS .MSG='B'20000 Abort message being displayed * 

TS .NRP='B‘'10000. Task mapped to nonresident partition * 
TS ..RUN='B' 4000 Task is running on another processor * 
TS .OUT='B' 400 Task is out of memory * 

TS .CKP='B' 200 Task is being checkpointed * 
TS.CKR='B'100 Task checkpoint reguested * 


Task Blocking Status Mask 
TS .BLK='B'TS.CKPITS.CKRITS.EXEITS.MSG!TS.NRP!ITS.OUT!TS.RDN 


Second Status Word (State Bits) 


T2.AST='B'100000 AST in progress * 

T2.DST='B' 40000 AST recognition disabled * 

T2.CHK='B' 20000 Task not checkpointable * 

T2.CKD='B'10000 Checkpointing disabled * 

T2.BFX='B'4000 ; Task being fixed in memory * 

T2.FXD='B' 2000 ; Task fixed in memory * 

T2.TIO='B'1000 Task is engaged in terminal I/O * 

T2.CAF='B' 400 Dynamic checkpoint space allocation 
failure * 

T2.HLT='B'200 Task is being halted * 

T2 .ABO='B'100 Task marked for abort * 

T2.STP='B'40 Task stopped * 

T2.STP='B'20 Task stopped * 

T2.SPN='B'10 Saved TS.SPN on AST in progress 

T2.SPN='B'4 Task suspended * 

T2.WFR='B'2 Saved TS.WFR on AST in progress 

T2.WFR='B'1 Task in waitfor state * 


Third Status Word (Attribute Bits) 


T3 .ACP='B'100000 Ancillary control processor * 

T3.PMD='B'40000 Dump task on synchronous abort 

T3.REM='B‘'20000 Remove task on exit * 

T3.RPV='B'10000 Task is privileged * 

T3.MCR='B‘' 4000 Task was reguested as external MCR 
function * 

T3..SLV='B' 2000 Task is a slave task * 

T3.CLI='B'1000 Task is command line interpreter * 

T3.RST='B'400 Task is restricted * 

T3.NSD='B'200 Task does not allow send data 
T3.CAL='B'100 Task has checkpoint space in task 
image 
T3.ROV='B'40 Task has resident overlays 

T3 .NET='B'20 Network protocol level 


Figure 2-14 Task Control Blocks (Part 2 of 2) 
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CHAPTER 3 
INTERRUPT PROCESSING 


3.1 INTRODUCTION 


This chapter discusses the internal operation of the RSX-11M interrupt 
“mechanisms. Flow diagrams of important routines are included in this 
chapter. 


3.2 INTERRUPT MECHANISMS 


RSX-11M is a priority driven, multiprogramming, real-time operating 
system. As with any such system, its principle function is 
multiplexing the sharable resources among competing tasks. The 
multiplexing itself is made possible by the interrupt system of the 
hardware that causes control to be taken away from user tasks and 
given to the Executive. It is during this period of interrupt control 
that the Executive makes decisions about granting use of shared 
resources. Understanding the interrupt mechanism is fundamental to 
understanding the Executive. Once this is understood, the knowledge 
serves as a framework for describing the operation of Executive 
subsystems (drivers, I/O, etc.) and the system as a whole. 


3.2.1 Hardware Interrupt Mechanisms - Review and Overview 
The PDP-11 family of computers has two classes of interrupts: 

l. Processor traps 

2. External interrupts 
Processor traps cannot be masked (blocked) in any way by altering the 
priority of the processor. When processor traps occur the processor 
enters the trap sequence of pushing the PS and PC onto the current 
stack (system or user) and retrieving the PS and PC from the proper 
hardware trap vector. If no other interrupts are pending when this 
occurs, the processor then begins at the location specified by the 
trap vector. A table of trap vectors starts at location 0 in low 
memory and extends to location 774(8). However, RSX-11M does not use 
locations 0 and 2 as vectors. Processor traps include the: 

Breakpoint trap (BPT) instruction 

Emulator trap (EMT) instruction 

Input/Output Trap (IOT) instruction 


TRAP instruction 
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11/40 floating-point exception fault 
Odd address 

Power fail 

Illegal instruction 


External interrupts are hardwired to one of the four bus’ request 
levels of the processor. These interrupts are generally associated 
with I/O devices and are maskable. They can only cause an interrupt 
when the priority in the Processor Status Word (PS) is less than the 
priority of the interrupting source. Thus, by setting the processor 
priority in a trap vector PS word to an appropriate level, interrupts 
equal to or below that priority are locked out. 


Every device that causes an interrupt has an associated trap vector in 
the vector table located in lower memory. However, not all devices 
cause interrupts, therefore, those devices do not have associated trap 
vectors. 


3.2.2 Executive and Stack Processing 


All the vectors in the trap vector table must be initialized properly 
so that when a processor trap or interrupt occurs, an Executive 
interrupt routine obtains control of the processor. 


On an unmapped PDP-11, only one stack exists. This stack must. be 
multiplexed to service the user tasks and the Executive. Having only 
a single stack also implies a single processor state. The Executive 
must simulate a two state system. A single word, the stack depth 
indicator (SSTKDP) is used to control this simulation. 


On a mapped system, there are two stacks ~ the user stack and the 
system stack. 


When the word, SSTKDP, is equal to 1 the system is running in the user 
state; when it is zero or less, it is in the system state. All stack 
multiplexing is accomplished by testing the contents of this word. 
Note that the priority set in the PS word for user tasks (both 
privileged and unprivileged) is 0, and for Executive routines, when 
running interruptable, is either 0, 7 or the level at which the 
interrupt was taken. These priorities play an important part in the 
goal to operate the Executive and its associated routines 
non-interruptable for as short a duration as possible. 


Describing the RSX-11M interrupt mechanism involves several 


interrelated routines, and it may be necessary for you to read the 
following section twice before the process becomes completely clear. 


3.3 INTERRUPT PROCESSES 


The RSX-11M interrupt machinery involves the following routines or 
routine types: 


Interrupt processor (both external interrupts and traps); 


The Interrupt Save Routine (SINTSV); 


INTERRUPT PROCESSING 


The Directive Save Routine (SDIRSV); 
The Interrupt Exit Routine (SINTXT); 
The Directive Exit Routine (SDIRXT); and 
The Fork Processors ($FORK,SFORKO,$FORK1). 


For resident drivers only, the device interrupt vector must be 
initialized when defining data structures, and not dynamically. This 
practice makes the driver code independent of device register address 
assignments and of the actual location of the interrupt vector. The 
driver data structure must include a storage assignment and 
initialization for the interrupt vector with the priority set to PR7. 


Writers of loadable drivers do not initialize the device interrupt 
vector. The vector is dynamically established by Load when the driver 
is loaded. When a driver is unloaded, Unload sets the vector to the 
system nonsense interrupt entry point. 


Driver interrupt processing routines are entered directly from the 
vector and usually use the INTSV$ macro for state switching services; 
at the completion of these services, the interrupt routines are again 
given control to complete the interrupt service. The exit routines 
SINTXT and S$DIRXT restore the state prior to switching to the system 
state, control the unnesting of interrupts, and make checks on the 
state of the system (for example, is it necessary to redispatch the 
processor). The Fork processing routines linearize access to shared 
system data bases. The details of all these routines are discussed 
later in the text. 


3.3.1 The INTSVS$ Macro 
INTSVS is a system macro that minimizes coding differences between 
loadable and resident drivers. INTSVS contains conditionally 
assembled code to handle: 

1. Single or multiple controllers 

2. Loadable or resident drivers 

3. Mapped or unmapped systems 
This macro is reguired for loadable drivers on mapped systems, because 
interrupts from hardware devices must be processed in kernel address 
space. In particular, the decoding of the PS word and the call to 
SINTSV must be done before entering the driver. Thus, a call to the 
Executive routine SINTSV within a loadable driver is illegal, and the 
MCR Load function returns an error if loading is attempted. 
When the INTSVS$ macro is used for a loadable driver in a mapped 
system, the Load function allocates a block of dynamic memory in 
kernel address space to contain the interrupt coding. This block, 
called the Interrupt Control Block (ICB), also contains coding to: 

1. Save the kernel mapping (APR5) 

2. Load APR5 to map the driver 

3. Transfer to the driver 


4. Restore the mapping after return 
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The Load function also sets up the controller's interrupt vector. so 
that hardware interrupts point to the ICB. 
Finally, the use of the INTSVS macro in a loadable driver on a_ mapped 
system requires that the symbol LDSxx (where xx is the 2-character 


device mnemonic) be defined either in the driver source or the 
assembly prefix file RSXMC.MAC. 


3.3.1.1  INTSVS Macro Format - The format of the INTSVS macro is: 


INTSVS xx,pri,nctlr[,pssave,ucbsave] 


wheres: 

XX is the 2-character device mnemonic. 

pri is the priority of the device (the priority that 
would be used in a call to S$INTSV). 

netlr is the number of controllers the driver services. 

pssave is an optional argument specifying a variable in 
which to save the PS word. If omitted, a variable 
named TEMP is used. 

ucbsave is an optional argument specifying a block of 


contiguous words in which to retrieve the 
interrupting device's UCB address. If omitted, a 
block of contiguous words named CNTBL is used. 


Outputs: R4 is the controller index, only if nectlr is greater 
than l. 


R5 is the UCB address. 
Example: 


INTSVS PP,PR4,P$SP11 


3.3.2 External Interrupt from the Task State ($STKDP=1) 


The vectors in lower memory contain a PC unique to each interrupting 
source, anda PS set with a priority of PR7. Hence, when an external 
interrupt occurs, the hardware pushes the current PS and PC onto the 
current stack (in this case the task's stack) and loads the new PC and 
PS (set at PR7) from the appropriate interrupt vector. The interrupt 
routine then starts executing with interrupts locked out. Interrupt 
routines may, in fact, be executing in one of three states: 


1, At PR7 with interrupts locked out; 


2, At the priority of the interrupting source; thus, interrupt 
levels greater than the source are permitted, or 


3. At Fork level which is at PRO. 


By internal convention, processing in the PR7 state is limited to 
100us. If processing can be completed in this time, then the 
interrupt routine simply RTI's; the interrupt has been processed and 
dismissed with minimal overhead. 
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If the interrupt routine requires additional processing time (but does 
not intend to alter a shared system data base) it uses the INTSV$ 
macro. The priority at which the caller is to run is included in the 
INTSV$ macro or the call to S$INTSV. With loadable drivers the 
Interrupt Control Block calls $INTSV. Therefore, the driver _ cannot 
use a CALL to $INTSV; it must use the INTSV$ macro. 


The interrupt save routine, SINTSV, uses the priority specified in the 
INTSV$ macro line (the interrupting source priority) to set up the 
interrupt routine. At this point in the process, the interrupt 
routine is interruptable by devices with priorities higher than that 
of the interrupting source. The SINTSV routine then conditionally 


switches to system state if the processor is not already in system 
state. 


3.3.2.1 S$INTSV Routine - The SINTSV algorithm is: 
SINTSV: Push R5 and R4 onto the current stack. 
Decrement stack depth indicator, S$STKDP. 
Is the stack depth indicator =0? No; go to l. 
Save the current (a task's in this case) stack pointer. 


Set up the System stack pointer (switch stacks if not 
MSSMGE) . 


1. Load the new processor priority as specified by the caller. 
Return to caller. 
Note: 


The stack depth indicator, S$STKDP, is zero only after the transition 
from the user state to the system state occurs. 


The JSR R5,SINTSV instruction pushes R5 on the stack prior to entering 
the SINTSV routine. Pushing of R4 and RS is done to free these 


registers for routines processing external interrupts. It is an 
internal programming convention that assumes these routines will not 
require more than two registers to accomplish their functions. LE 


they do, they must save and restore any additional registers they use. 


3.3.2.2 INTSVS Macro - The interrupt save macro, INTSV$, expands as 
shown in Figure 3-l. 


3.3.3 External Interrupts from the System State (SSTKDP <=0) 


The code on this interrupt path is identical to that discussed in 
External Interrupt from the Task State. However, it is not necessary 
for the task to switch states when the INTSV$ macro is used. The 
current stack is the system stack, and when SINTSV tests the value of 
the stack depth indicator, S$INTSV bypasses saving the SP and switching 
the stacks. After SINTSV saves R4 and R5 on the system stack, it 
returns to the driver interrupt routine. 
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»MACRO INTSVS DEV,PRI,NCTRLR,PSWSV,UCBSV 
~IF NDF LSSDRV ! MSSMGE ! LDS'DEV 

-IF GT NCTRLR-1 

.IF B <PSWSV> 

MFPS TEMP 

~IFF 

MFPS PSWSV 


- ENDC 
~ IFTF 


JSR R5,SINTSV 
-IF DF LS$SIl 


~WORD PRI 
-IFF 


»WORD ~C<PRI>&PR7 


»ENDC 
~ IFT 


-IF B <PSWSV> 


MOV TEMP ,R4 


~ LFF 


MOV PSWSV,R4 


- ENDC 


BIC #177760,R4 


ASL R4 
«ENDC 
- ENDC 


GTUCBS UCBSV,NCTRLR 


- ENDM 


=e we Ne 


SPPINT:: 


Figure 3-1 


INTSV$ Macro Expansion 


**—SPPINT-PCl11 PAPER TAPE PUNCH CONTROLLER INTERRUPT ROUTINE 


;REF LABEL 


ee 
INTSVS PP,PR4,PSSP11 77#7GENERATE INTERRUPT SAVE CODE 
MOV U.SCB(R5) ,R4 777GET ADDRESS OF SCB 
MOVB S.ITM(R4),S.CTM(R4) 77;RESET TIMEOUT COUNT 
MOV S.CSR(R4) ,R4 777POINT R4 TO CSR 
MOV (R4)+,U.CW3 (R5) 77;SAVE STATUS 
BMI 60$ 777IF MI, ERROR 
SUB #1,U0.CNT(R5) :33DECREMENT CHARACTER COUNT 
BCS 50$ r77IF CS, THEN DONE 
TSTB U.CW2(R5) 777 CURRENTLY PUNCHING TRAILER? 
BPL 30$ 777IF PL NO 
CLRB (R4) 777LOAD NULL INTO OUTPUT REGISTER 
BR 40$ 73?BRANCH TO LOAD IT 
308: CALL SGTBYT 777GET NEXT BYTE FROM USER BUFFER 
MOVB (SP) +, (R4) 777LOAD BYTE INTO OUTPUT REGISTER 
408: JMP SINTXT 777EXIT FROM INTERRUPT 
50$ INC U.CNT(R5) 777RESET BYTE COUNT 
60$: CLR - (R4) 777DISABLE PUNCH INTERRUPTS 
CALL $ FORK 777CREATE SYSTEM PROCESS 
MOV U.SCB(R5) ,R4 ;POINT R4 TO SCB 
MOV S.PKT(R4) ,Rl. ;POINT R1 TO I/O PACKET 
MOV I.PRM+4(R1),R1 ;AND PICK UP CHARACTER COUNT 
SUB U.CNT(R5) ,R]. ;CALCULATE CHARACTERS TRANSFERRED 
MOV #IS .SUC&377,R0 ; ASSUME SUCCESSFUL TRANSFER 
TST U.CW3(R5) ;DEVICE ERROR? 
BPL 70$ :;IF PL NO 
65S: MOV #IE.VER&377,R0 ;UNRECOVERABLE HARDWARE ERROR CODE 
70S: CALL $IODON ; INITIATE I/O COMPLETION 
BR PPINI ;BRANCH BACK FOR NEXT REQUEST 


Figure 3-2 Example of a Driver Using SINTSV 
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3.3.4 Processor Traps from the Task State (SSTKDP<=1) 


when a processor trap occurs from the task state, the hardware pushes 
PS, PC, and initiates the routine specified in the associated hardware 
trap vector. If an Executive directive causes the trap, EMT 377, the 
Directive Parameter Block (DPB) or its address was pushed onto the 
user task's stack prior to the issuance of the EMT. 


Also, the task can cause a processor trap by issuing the SWSTKS macro. 
See Chapter 4 for an explanation of the SWSTKS macro. 


The trap routine, running at PR7, immediately calls the routine S$DIRSV 
(Directive Save), which has the following algorithm: 


SDIRSV: Push R5 and R4 onto current stack 
Decrement stack depth indicator. 
Is the stack depth indicator <20? No, go to l. 
Save current task's stack pointer. 
Set up system stack pointer (switch stacks if not MSSMGE). 
l. Push R3, R2, R1, RO onto current (system) stack. 
Load new processor priority as specified by the caller. 


Return to caller. 


The SSTKDP check is made to improve crash analysis; no other 
decisions are made in SDIRSV because all processor traps, with the two 
exceptions of the Trap instruction or Powerfail, occur from the _ task 
state. The exceptions are handled on exit. All registers are saved; 
the need for only two registers, R5 and R4 is assumed only for 
routines processing external interrupts. As with S$INTSV, the priority 
at which the caller expects to run immediately follows the call. All 
processor trap routines, however, run interruptable. 


Only one processor trap can be queued for processing in the system at 
any point in time (ignore, for the moment, the two exceptions we have 
noted). Because the processor trap occurred in task state, entrance 
to the Executive occurs only when the Executive is idle. While in the 
system state, only external interrupts can occur. If processor traps 
occur, then either they are valid exceptions, or the system itself has 
faulted and shuts down. 


Once a valid processor trap is pending, it is processed to completion 
before any other system routine is given access to any shared system 
data base. This strict sequentiality is accomplished with the _ two 
exit routines S$INTXT, $DIRXT and the fork processors (S$FORK, S$FORKO, 
and $FORKI). 


3.3.4.1 Example use of S$DIRSV - Figure 3-3 shows the code for the 
Emulator Trap (EMT) processing routine, SEMTRP. 
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+ 


EMT TRAP PROCESSING ROUTINE 


THIS ROUTINE IS ENTERED VIA THE VECTOR AT LOCATION 30 WHEN AN EMT 
INSTRUCTION IS EXECUTED. THE ROUTINE IS ENTERED IN SYSTEM STATE. 
IF THE STACK DEPTH IS NOT 0 AFTER THE DIRSVS$ MACRO EXECUTES, 

THE SYSTEM CRASHES. 


=e %O te we Ne BE NO SE 


SEMTRP: :DIRSVS 
»MACRO DIRSVS 
JSR R5,SDIRSV 


777SAVE REGISTERS AND SET PRIORITY 


- ENDM 
TST SSTKDP ;WERE WE AT STACK DEPTH +1 
BNE 70$ ;IF NE 0 - NO —- CRASH SYSTEM 
MOV @SHEADR 7;GET SAVED STACK POINTER 
CMP (R3)+, (R3) + ;POINT TO USER PC WORD 
MOV (R3)+,R5 ;GET ADDRESS OF EMT +2 


~IF DF MSSMGE 


MFPI - (R5) ;GET DIRECTIVE WORD 
CMP #104377, (SP) ;DIRECTIVE EMT 377? 
BNE 80S ;IF NE O -NO- 
MOV #1, (SP) ;SET SUCCESSFUL DIRECTIVE STATUS 
eITFF 
CMP #104377,-(R5) ;DIRECTIVE EMT 377 
BNE 80$ ;IF NE 0 -NO- 
MOV #1,-(SP) 7;SET SUCCESSFUL DIRECTIVE STATUS 
~IFTF 
MOV #USRPS,R5 ;POINT TO LOCAL DATA 
MOV R3, (R5) + 7;SAVE ADDRESS OF USER PS 
BIC (SP) , (R3) + ;CLEAR CARRY IN USER PS WORD 
CLR (R5) ; INDICATE NO BYTES 

g0$: 
IF DF MSSMGE 
MOV SHEADR,R5 ;POINT TO CURRENT TASK HEADER 
MOV H.WND(R5),R5 POINT TO NUMBER OF WINDOW BLOCKS 
TST W.BLVR+2 (R5) ;CURRENT TASK MAPPED TO EXEC 
BEQ 85S 7IF EQ 0 -NO- 
CMP (SP) , #104376 7IS THIS A CALL TO SSWSTK 
~IFF 
CMP (R5) , #104376 ;IS THIS A CALL TO SSWSTK 
eENDC 
BNE 85$ 7;IF NE O -NO- 
JMP SSWSTK 7PROCESS CALL TO SSWSTK 

85S; JMP SEMSST s;PROCESS SST FAULT 

Figure 3-3 Example of Use of SDIRSV by the SEMTRP Routine 
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SDIRSV: :MOV R4,~-(SP) 777SAVE R4 
DEC SSTKDP 777SET PROPER STACK DEPTH 
BNE 10$ 733IF NE, DON'T SWITCH STACKS 
MOV SP,@SHEADR +7?7SAVE CURRENT SP 


-IF NDF MSSMGE 


MOV #SSTACK,SP 373LOAD SYSTEM STACK POINTER 
- ENDC 
LOS: MTPS #0 77;7;ALLOW INTERRUPTS 
MOV R3,-(SP) 7;SAVE REGISTERS R3-RO ON STACK 
MOV R2,~-(SP) ; 
MOV R1l,- (SP) ; 
MOV RO,- (SP) ; 
CALL (R5) ;CALL SYNCHRONOUS TRAP ROUTINE 
BR SDIRXT ;EXIT FROM TRAP 


Figure 3~3 (Cont.) Example of Use of $DIRSV by the SEMTRP Routine 


3.3.5 Processor Traps from the System State (S$STKDP <=0) 


Only two processor traps are valid from the system state: the Trap 
instruction and Powerfail. If any other processor trap occurs while 
in the system state, the system's operation is aborted or XDT, the 
Executive debug tool, is entered if it is present. 


3.3.5.1 Processing for Trap Instructions Occurring in System 
State - The Executive uses the trap instruction as a core saving 
technique in returning status following the execution of an Executive 
directive. The EMT 377, which is the processor trap used to initiate 
directives, causes entry into the directive dispatcher (SEMTRP) which 
in turn calls S$DIRSV. See Figure 3-3. On return from $DIRSV, but 
before calling the directive processing routine, the directive 
dispatcher pushes a value of +1 onto the system stack, and clears the 
C bit in the PS word stored on the user's stack. It then calls the 
proper directive processing routine to execute the directive. Figure 
3-4, Stack Stack Upon Entry into“Directive Processing, shows the state 
of the user and system stacks for both the unmapped and mapped systems 
at the time entry is made to the routine that processes the issued 
directive. 


The directive processing routine now carries out its function, and in 
so doing is free to alter any shared system data base, because no 
other routine can gain access to a shared data base until the 
directive processing routine is completed. This arrangement of the 
stack and interface between the directive dispatcher and the directive 
processors has two advantages: 


1. The normal return for all but a few directives is a +1 status 
and carry clear. This means the directive routines can 
return to the dispatcher with an RTS; thus the return path 
is one word rather than the two needed if a JMP is employed; 
this scheme probably saves 100 words in the RSX-11M 
Executive. 


2. Internal Executive routines can call the directive processing 
routines without using an EMT. 
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Figure 3-4 Stack State Upon Entry into Directive Processing 


If a directive processing routine needs to return a status other than 
+1, and have the carry stat clear, the routine replaces the +1 on the 
stack with the value it intends to return and then executes an RTS. 


Now to the use of the Trap instruction within the Executive. If a 
directive processing routine must return a status other than +1 and, 
in addition have the carry stat set, or cleared, based on the status 
value returned, it then uses the Trap instruction with the value of 
the status to be returned in the low order byte of the instruction. 
When the trap processing routine is entered, it immediately checks for 
stack depth=0, and if 0, proceeds to reset the stack for correct 
exiting from a directive processing routine. The low order byte of 
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the trap instruction itself overlays the +l status currently on _ the 
stack; this value is tested and, if minus, the carry stat is set in 
the user task's PS word. If plus, the carry stat is left cleared. 
After this processing, the exiting code of the directive dispatcher is 


entered just as if the directive processing routine had executed an 
RTS. 


If the initial test for a stack depth indicator of 0 fails, the trap 
processing routine calls $DIRSV. This call is logically incorrect if 
the stack depth indicator was less than zero. This programming error 
is recognized on exit. On return from SDIRSV, the trap processing 
routine checks the stack depth indicator, and if it is not zero, the 
system crashes. 


Note that directives are legitimate only from the task state (stack 
depth indicator=1) so that during directive processing, the stack 
depth indicator is always 0. Interrupts that occur in system state 
disappear from the stack before the directive processing sequence 
resumes following an interrupt. Hence, even though the stack can grow 
while a directive processing routine is in control, this growth is 
transparent to the routines. Stating it from a different perspective, 
interrupts are permitted but the directive processing routine that is 
in control is unaware of them. 


Thus, directive processing routines have three methods of returning 
status: 


1. For the normal return carry clear and status egual to tl, 
they use an RTS. 

2. For carry clear and status other than +1, they overlay the +l 
Status on the stack with the desired status value (status 
value is at 2(SP)) and RTS. 


3. For carry clear or set, and status of one byte, they use the 
trap instruction. This requires more overhead than 1 and 2 
above but saves memory, and, of course is the required return 
mechanism if carry is to be set. 


Together, these return mechanisms from directive processing routines 
save between 200 and 300 words in the RSX-11M Executive as compared to 
returning via jump instructions. 


3.3.6 Powerfail Processing 


When a power failure occurs, the power failure trap processing 
routine, PDOWN: - in the POWER module, is entered. This routine 
saves the state of the system, sets up a new power failure trap-vector 
PC for use when power is restored, calls the user's powerfail routine 
if it's defined, then halts. 


On restoration of power, the state of the system at the time the 
failure occurred is restored, the SPWRFL flag is set indicating that a 
power failure has occurred, the reschedule pointer $ROQSCH is set, and 
the clock is re~enabled. Then, the restoration code issues an RTI, 
which results in the resumption of the processing that was in progress 
when the power failure occurred. The specific processing to reflect 
the occurrence of a power failure does not occur until either 
Directive Exit is entered or the clock interrupts. In any event, this 
processing is part of Directive Exit and is discussed under Directive 
Exit. 
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Note that power failure processing is not asynchronous. As much as 
1/60 of a second could elapse following restoration before the power 
failure is acted upon. The records and logic needed to provide 
asynchronous power failure processing are simply too large for a 
system with the memory objectives of RSX-l1M. 


3.3.7 Processing Within Interrupt Routines 


In this section, we detail the events that take place following 
interrupt entry up to the point where the Executive is ready to return 
control to the task state. 


Once the Executive is entered via an interrupt (regardless of the 
state it is in when the interrupt occurs) it does not again return to 
the task state until all system related processing for that interrupt 
has been completed. 


A single interrupt in the task state causes transfer into the system 
state where the system remains until the interrupt is processed. But 
while in the system state, repeated interrupts can occur. This 
implies a fixed interrupt depth of one for the task stack (reguiring a 
task to provide a stack of at least four words in an unmapped system), 
and implies a variable interrupt depth for the system stack. 


Because multiple interrupts can occur in the system state, RSX-11M 
resolves both of these logical difficulties by strictly linearizing 
interrupt processing and access to internal data bases. The 
mechanisms employed to accomplish this linearization are the system 
stack, fork processes, and the associated fork list. 


3.3.7.1 Queuing Interrupts on the System Stack - In the system state, 
the system must operate interruptable as much of the time as possible. 
Three possible conditions can exist when the system itself runs 
non~interruptable: 


1. The most recent interrupt is being processed at level PR7 and 
the driver interrupt routine has not yet returned to an 
interruptable state. 


2. The interrupt routine has dropped from level PR7 to the level 
at which the interrupt occurred. Priority levels, egual to 
Or less than the priority of the interrupting source are 
locked out. 


3. The system is updating a critical list whose consistency can 
only be Maintained by a non-interruptable instruction 
seguence. There are two such lists, and we will discuss them 
shortly. 


In the sections External Interrupts from the Task State and Processor 
Traps from the Task State, we examined the code sequence for 
processing external interrupts and processor traps, as well as_ the 
stack additions that occurred during their processing. Interrupt 
stacking in the system state occurs based principally on hardware 
interrupt levels. Thus, if a level PR4 interrupt is being processed, 
a level PR5, PR6, or PR7 interrupt can potentially interrupt this 
processing and cause context to be stacked and control given to the 
higher level interrupt routine. 
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3.3.8 Fork Processing 


Once a driver interrupt routine passes from a non-interruptable to an 
interruptable state by using a call to S$INTSV or the INTSVS$ macro, 
processing is at the same level as the priority of the interrupting 
source, However, along any given interrupt path, more processing is 
often required than the minimum non<-interruptable code seguences in 
the Executive permit. Along this path the allowable maximum 
non-interruptable processing time is 500us. Thus, a scheme is 
required to split interrupt processing routines further, such that 
part of their execution runs interruptable to any interrupting source. 
The mechanism for achieving this split is called fork processing. 


First, and most important, fork processing linearizes access to system 
data bases. Thus eliminating unwanted recursion and untimely updates 
of these data bases. A list associated with fork processing, the Fork 
List, is the method the system uses to linearize data base accessing. 


Driver and system interrupt routines are required to adhere to the 
following internal conventions: 


l. Use of any registers except R4 and R5 requires that’ these 
registers be saved and restored. 


2. Non-interruptable processing must not exceed twenty 
instructions. 


3. All modifications to system data bases must be done via a 
fork process. 


Along an interrupt path, control can be taken from a routine only due 
to a higher priority interrupt pending in the hardware. As discussed 
previously, these interrupts are kept track of on the system stack. 
When an interrupt routine needs to transfer from a non-interruptable 
to an interruptable state, or modify a system data base, it must call 
SFORK. SFORK, however, cannot be called directly from an interrupt 
routine; it must first switch to system state by calling SINTSV and 
then calling $FORK. 


By virtue of calling S$FORK, the routine is now interruptable and its 
access to system data bases is strictly linear. The Fork List is a 
list of system routines, usually I/O drivers, waiting to complete 
their processing, in particular, waiting to access a shared system 
data base. 


When the $FORK routine returns to SINTX1 after placing the fork block 
in the fork list, SINTX1 and S$DIRXT remove the stacked items for the 
driver interrupt routine. In effect the fork list is a secondary 
interrupt queue (stack) whose members are processed FIFO, and obtain 
processing time only if the system stack is empty. 


Note that the context saved for a caller of S$FORK depends on which 
entry point is called (SFORK or $FORK1), and the context saved is all 
that is needed to restart routines on the fork list. 


Figure 3-5 Example Driver Interrupt Routine shows the expansion of the 
INTSVS macro and the call to $FORK. 


+ 


me me YO 


INTSV$ 


TSTB 
BEQ 
MOV 
MOV 
MOV 
BMI 
BIT 
BNE 
TST 
RETURN 
40S: MOV 
508: CALL 


MOV 
MOV 
MOV 
MOV 
MOV 
BITB 
BNE 


51S 
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$XXINT DISK CONTROLLER INTERRUPT ROUTINE 


DK, PR5,RSSK1l1 777SAVE REGISTERS AND SET PRIORITY 


»MACRO INTSV3 DEV,PRI,NCTRLR,PSWSV,UCBSV 
~IF NDF LSSDRV ! MSSMGE ! LDS$'DEV 
~IF GT NCTRLR-1 

~IF B <PSWSV> 

MFPS TEMP 

~IFF 

MFPS PSWSV 

»ENDC 

~IFTF 

JSR R5,SINTSV 

-IF DF LSSSI1 

~WORD PRI 

.IFF 

~WORD “C<PRI>&PR7 

~ENDC 

IFT 

~IF B <PSWSV> 

MOV TEMP,R4 


~IFF 

MOV PSWSV,R4 

~ENDC 

BIC #177760,R4 

ASL R4 

~ENDC 

- ENDC 

GTUCBS UCBSV,NCTRLR 

~ENDM 

RTTBL+1 (R4) *3;;DRIVE RESET IN PROGRESS? 
50S 777IF EQ NO 

R4,~(SP) :3::SAVE CONTROLLER INDEX 
U.SCB(R5) ,R4 33;GET ADDRESS OF SCB 
@S.CSR(R4) ,R4 :3:2:GET CONTENTS OF CSR 

40$ *32IF MI DRIVE RESET ERROR 
#20000,R4 :373DRIVE RESET COMPLETE? 
40S s33IF NE YES 
(SP) + 77; CLEAN: STACK 

eee 

(SP) +,R4 +33 RESTORE CONTROLLER INDEX 
$ FORK 33; CREATE A SYSTEM PROCESS 


! 
; CONTROL IS REGAINED AT THIS POINT WITH ALL INTERRUPTS ALLOWED 


R4,R3 ;COPY CONTROLLER INDEX 

U.SCB(R5) ,R4 7;GET ADDRESS OF SCB 

S.CSR(R4) ,R2 ;GET ADDRESS OF CSR 
#IS.SUC&377,RO ;ASSUME SUCCESSFUL TRANSFER 
S.PKT(R4),R1 ;GET I/O PACKET ADDRESS 
#IQ.UMD,I.FCN(R1) ;DIAGNOSTIC FUNCTION EXECUTED? 
130$ ;IF NE YES 


Figure 3-5 Example Driver Interrupt Routine 
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3.3.8.1 SFORK - SFORK is in the file SYSXT. A driver calls $FORK to 
switch from a partially interruptable level (its state following a 
call on S$INTSV) to a fully interruptable level. 


Notes: 


l. S$FORK cannot be called unless S$INTSV has been previously 
called. The fork-processing routine assumes that SINTSV has 
set up entry conditions. 


2. A driver's current timeout count is cleared in calls to 
SFORK. This protects the driver from synchronization 
problems that can occur when an I/O request and the timeout 
for that request happen at the same time. After a return 
from a call to S$FORK, a driver's timeout code will not. be 
entered. 


If the clearing of the timeout count is not desired, a driver 
has two alternatives: 


a. Perform timeout operations by directly inserting elements 
in the clock queue (refer to the description of the 
SCLINS routine). 


b. Perform necessary initialization, including clearing 
S.STS in the SCB to zero (establishing the controller as 
not busy), and call the S$FORK1 routine rather than $FORK. 
Calling SFORK1 bypasses the clearing of the current 
timeout count. 


3. The driver must not have any information on the stack when 
SFORK is called. 


3.3.8.2 S$FORK1 - SFORK1 is the file SYSXT. A driver calls $FORK1 to 
bypass the clearing of its timeout count when it switches from a 
partially interruptable level to a fully interruptable level (refer 
also to the description of the S$FORK routine). 


Notes: 


1. For mapped systems with loadable driver support, a 5-~word 
fork block is required for calls to S$FORK1. 


2. When a 5-word fork block is used, the driver must initialize 
the fifth word with the base address (in 32-word blocks) of 
the driver partition. This address can be obtained from the 
fifth word of the standard fork block in the SCB. 


3. The driver must not have any information on the stack when 
SFORK1 is called. 


3.3.9 Exiting the System State 


Two routines SINTXT (Interrupt Exit) and SDIRXT (Directive Exit) 
result in the seguential removal of all items on the system stack, 
followed by all items on the Fork List. The following text discusses 
these two routines. 


The Executive's objective is to return to the idle state as fast and 
as efficiently as possible. It does this by servicing all routines on 
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the system stack first. These routines are usually running at some 
level of non-interruptability. When the system stack is cleared of 
pending requests, the Executive then services the pending requests on 
the Fork List. When both the Fork List and system stack are empty, 
the Executive either returns to the task state or if no task is 
active, waits for work to do (idles). 


SINTXT is transferred to by external interrupt processing routines 
that are running on the system stack at the priority of the 
interrupting source, 

$DIRXT has the task of servicing the Fork List and, when the Executive 


has no more work to do, restoring the task state. S$DIRXT is entered 
by trap routines, fork routines, and by SINTXT. 


3.3.9.1 SINTXT Routine - The S$INTXT algorithm is as follows: 
SINTXT:: Lock out interrupts. 
Is SSTKDP=0? No, go to l. 


Is Fork List empty (check SFRKHD)? No, reload user SP if 
memory management is not defined and go to l. 


Allow interrupts. 


Store R3, R2, Rl, RO on the current (system in this case) 
stack. 


Execute $DIRXT (Directive Exit). 
1. Increment stack depth indicator. 

Restore R4 and R5 from current stack and RTI. 
Notes: 
Interrupts must be locked out to insure a consistent check of S$STKDP 
and the contents of the Fork List. The same type of lockout occurs in 
directive exit. There are two non-interruptable code spans used to 
check and update the Fork List. One is in S$FORK, and one in SDIRXT. 
The saving of R3 thru RO is preparatory to the jump to $DIRXT, which 
expects these registers on the stack. Note that the path through the 
Executive that finds both the Fork List empty and the stack depth 


indicator equal to 0 is fairly common. This is the minimum overhead 
path. 


3.3.9.2 Directive Exit - The S$DIRXT algorithm is as follows: 
$DIRXT:: Lock out interrupts. 
Check S$FRKHD. Anything in Fork Queue? No, go tol. 


Remove entry from Fork Queue and update Fork Queue listhead 
pointers. 


Allow interrupts. 


If memory management and loadable drivers are defined, save 
APR5 and map the driver. 
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Restore fork context (registers R4 and R5). 

Restore APRS if memory management is defined. 

Call routine whose fork context was restored (CALL @-(R3)). 
Go to $DIRXT._ 


1. Is rescheduling reguired ($RQSCH not=0)? No, restore 
registers RO-R3 and go to 2. 


Allow interrupts. 

Is the power failure flag (SPWRFL) set? Yes, go to 3. 
Clear $RQSCH. 

Save context of current task. 

Locate a ready-to-run task. 

Load and check context of new task. 


Map windows of new task for correct mapping determined by 
task privilege. 


Go to $DIRXT. 
2. Restore task stack pointer (from @$HEADR to SP). 
Increment stack depth indicator, $STKDP. 
Restore R4 and R5 from user stack and RTI. 
3. Call power failure processing (CALL $POWER). 
Go to $DIRXT. 
Notes: 
SDIRXT calls both waiting fork processes and the powerfail routine. 
These routines terminate via an RTS instruction. On return $DIRXT 
again cycles looking for work. 
The task reschedule pointer, $RQSCH, controls the redispatching of the 
processor. It points to the location in the STD list where $DIRXT 
should begin its scan for a task ready to use the processor. 
SROSCH is set when a change of state has occurred in the system that 
might cause a task other than the one currently in control to obtain 
processor time. Examples are I/O done, clock gueue runout, or a task 


doing an EXIT. The word is reset by $DIRXT just prior to its 
dispatching a new task. 


3.3.10 Interrupt Processing Code 


Figure 3-6 shows the driver and system interrupt code that is used in 
processing interrupts. The lines in Figure 3-6 shows the flow of 
control from routine to routine. The numbers associated with the 
lines indicate the sequence of events. 
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3.3.11 Interrupt Processing Summary 


The following seven types of routines not only comprise the interrupt 
system, but practically comprise the entire Executive itself: 


External Interrupt Routines 
Trap Routines 

Interrupt Save 

Directive Save 

Fork and Fork Processes 
Interrupt Exit 

Directive Exit 


External interrupts cause traps to external interrupt processing 
routines which run in one of three states: 


1. Non-interruptable at PR7. 
They run here when initially entered. 


2. Interruptable by priorities higher than the interrupting 
source. 


Both states 1 and 2 are linearized being queued and dequeued 
from the system stack. 


3. Fully interruptable as fork processes. 


Trap routines, of which only one may occupy the system stack during 
any given passage through the Executive, operate at priority level 
zero, need never call Fork, and operate entirely from the system 
stack. 


Interrupt save is called by driver interrupt routines when they make a 
transition from non-interruptable to interruptable. 


Directive save is called by trap routines. 
Fork creates a fork process for external interrupt routines. 


Interrupt Exit unstacks waiting routines from the system stack, and 
when the system stack is empty drops into Directive Exit. 


Directive Exit gives control to waiting fork processes, processes 
power failure, and redispatches the processor. 


The Executive structure has a sequentiality which obviates the need 
for any explicit synchronizing mechanisms. Privileged tasks that 
follow the internal conventions of the Executive are never concerned 
with multiple-update of shared system data bases. While progressing 
toward the idle state the Executive gives priority to routines on the 
system stack, then to fork processes. 


CHAPTER 4 


PRIVILEGED TASKS 


4.1 INTRODUCTION 


This chapter discusses privileged tasks: what they are, the hazards 
to the system that they present, and how they are mapped. 


4.2 PRIVILEGED TASKS 


A privileged task has a special access to memory locations and devices 
that a nonprivileged task does not have. Specifically, certain 
privileged tasks can examine and use the values in system control 
blocks. These tasks can also examine and use Executive code. Also, 
certain privileged tasks can directly access the device registers in 
the I/O page. A privileged task can read from or write to a volume 
whether or not that volume is mounted (via the Mount command) or 
allocated to another user. These abilities imply that a privileged 
task has every ability that the Executive has, and, in fact, it does. 
It may be helpful to conceive of the privileged task as part of the 
Executive because certain privileged tasks are mapped with the 
Executive and I/O page. See Task Mapping in this chapter. As the 
writer of a privileged task, you are obliged to take every precaution 
so aS not to damage the Executive, system, or user code and data. 


4.2.1 Privileged Task Hazards 


Privileged tasks are potentially hazardous to a running system. A 
privileged task can corrupt the system and disable devices. Bugs in 
these tasks are obscure and difficult to find. For these reasons, you 
must be cautious when developing and running a privileged task. 


Make certain that your privileged task has completed its operation 
when you log off the system (say "“BYE"). BYE does not abort 
privileged tasks as it does nonprivileged tasks. BYE cannot abort a 
privileged task because the privileged task may be in the process of 
changing the system data base. Therefore, it must be allowed to 
complete its processing. Also, if the privileged task is in 
system-state, BYE or no other task can execute until the privileged 
task completes its processing while in system-state. However, when 
the privileged task leaves system-state, BYE runs and logs you off the 
system, leaving the privileged task still in operation. 


If a processor trap occurs in a privileged task while the task is in 
user-state, the Executive aborts the task. However, if the processor 
trap occurs in the privileged task while the task is in system-state, 
the system crashes. However, even while in user state the privileged 
task that is mapped to the Executive can cause a system crash by 
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incorrectly changing system data. Please note that a privileged task 
in user-state should not be modifying system data. 


Note that all tasks in an unmapped system can access all of memory. 
The privileged or nonprivileged designation has no particular meaning 
in an unmapped system. However, be just as careful about modifying 
Executive, device, or user data in an unmapped system. 


4.2.2 Specifying a Task as Privileged 


To specify a task as privileged, you must use the /PR switch in the 
Task Builder command line when you build your task. The RSX-11M Task 
Builder Reference Manual describes the use of this switch. You can 
use one of three numeric arguments with the /PR switch: 0, 4, or 5 
(specifically as /PR:0, /PR:4, or /PR:5). The abilities and mapping 
of the privileged tasks designated by these switch values are 
described next. 


4.2.2.1 /PR:0 Privileged Task 


Using the /PR:0 switch causes the Task Builder to reserve user APAR 0 
for mapping the task, which is the same as any other task. Virtual 
address space begins at virtual address 0 and extends upwards as far 
as 32K minus 32 words. This task cannot access’ the Executive 
routines, system data structures, or directly access the I/O page 
because the Task Builder has not reserved APRs for these purposes. 


However, a task mapped into APR 0 can access the I/O page through a 
device common. The RSX-11M Task Builder Reference Manual discusses 
device commons. To do this, you must build a device common that 
occupies physical addresses on the I/O page. Then, when the task is 
built, you associate the common with the task by using the COMMON= or 
RESCOM= keyword. 


There are four advantages to using a /PR:0 task and having it mapped 
into APR 0: 


1. The task has more virtual address space available. A task 
Mapped through APR 0 that accesses the I/O page can be as 
large as 28K words, 


2. A device common provides you with the means to associate 
symbolic names with physical addresses in the I/O page. 


3. You can restrict the amount of space to which the task has 
access on the I/O page. When you specify an argument of 
either 4 or 5 on the /PR switch, the Task Builder always 
allocates the entire I/O page. However, a device common can 
be as small as 32 words - expanding upwards (in 32-word 
blocks) to 4K words. Therefore, your task needs access to 
only the portion of the I/O page that it requires. Thus, 
there is less chance that the task will alter the wrong data 
and destroy the running system. 


4. A /PR:0 task can write logical block I/0 to a= physically 
mounted volume, regardless of who issued the Mount or 
Allocate command. For example, the VMR task is a /PR:0 task 
and writes to mounted volumes during the SYSGEN process. 
However, this advantage can be hazardous for obvious reasons. 
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A /PR:0 task runs in user state and cannot switch to system state. 
Also, a /PR:0 task is not mapped to the Executive. If you want to 
write a privileged task that does I/0 processing, it is to your 
advantage to use the /PR:0 switch for your task because there is less 
chance of corrupting the Executive or system code and data. 


4.2.2.2 /PR:4 Privileged Task 


If you want your privileged task to map to the Executive and I/O page, 
and your Executive is 16K or less, use the /PR:4 switch in the Task 
Builder command line. If you specify /PR:4 for your task, the Task 
Builder reserves APR 7 to map the I/O page and reserves APRs 0 through 
3 to map the Executive as part of your task's virtual address space. 
The /PR:4 switch can be used only if your Executive size is 16K or 
less because the 16K Executive uses APRs 0 through 3 and your task is 
assigned mapping that starts with APR 4. Therefore, the Task Builder 
applies a bias of 100000 (16K decimal) to all virtual addresses within 
the task. This specific mapping of APRs 0 through 4 and 7 occurs 
whether the task is in user- or system-state. 


There is up to 12K words of virtual address space possible in a /PR:4 
task. The beginning of the task marks the end of the Executive code. 
If the task is 12K words in size, the end of the task marks the start 
of the I/O page. If the task is going to access the I/O page through 
APR 7, the task cannot exceed the 12K limit. If the task does exceed 
the limit, the Task Builder is forced to assign APR 7 to the task 
code. When building the task, the Task Builder does not give you an 
error message if your task exceeds the 12K limit. However, when you 
install the task, the system task, Install, sends you the following 
message: 


"INS -- WARNING -- PRIVILEGED TASK OVERMAPS THE I/O PAGE" 


This message is a warning that your task will most likely hang if it 
tries to access the I/O page. 


A /PR:4 task can access all of the Executive, system control blocks, 
and 1/0 page. It can use Executive routines and do logical block I/0 
to a volume that is physically mounted on a device. Also, the /PR:4 
task can issue a S$SWSTK macro to change from user- to system-state. 
This allows the task to access the Executive or system code without 
interruptions or fear of the data being changed while it is being 
accessed. See SSWSTK in an Unmapped System or S$SWSTK in a Mapped 
System in this chapter. 


4.2.2.3 /PR:5 Privileged Task 


If you want your privileged task to map to the Executive and I/O page, 
and your Executive is between 16K and 20K, use the /PR:5 switch in the 
Task Builder command line. If you specify /PR:5 for your task, the 
Task Builder reserves APR 7 to map the I/O page and reserves APRs 0 
through 4 to map the Executive as part of your task's virtual address 
space, The /PR:5 switch can be used only if your Executive size is 
between 16K and 20K because the 20K Executive uses APRs 0 through 4 
and your task is assigned APR 5. (APR 5 may be used if the Executive 
is less than 16K, but this wastes virtual address space.) Therefore, 
the Task Builder applies a bias of 120000 (20K) to all virtual 
addresses within the task. This specific mapping of APRs 0 through 5 
and 7 occurs whether the task is in user- or system-state. 


PRIVILEGED TASKS 


There is up to 8K words of virtual address space (12K if the I/O page 
is overmapped) possible ina /PR:5 task. The beginning of the task 
Marks the end of the Executive code. If the task is 8K words in size, 
the end of the task marks the start of the I/O page. If the task is 
going to access the I/O page through APR 7, the task cannot exceed the 
8K limit. If the task does exceed the limit, the Task Builder is 
forced to assign APR 7 to the task code. When building the task, the 
Task Builder does not give you an error message if your task exceeds 
the 8K limit. However, when you install the task, the system task, 
Install, sends you the following message: 


"INS -- WARNING -- PRIVILEGED TASK OVERMAPS THE I/O PAGE" 


This message is a warning that your task will most likely hang if it 
tries to access the I/O page. 


A /PR:5 task can access all of the Executive, system control blocks, 
and I/O page. It can use Executive routines and do logical block I/0 
to a volume that is physically mounted on a device. Also, the /PR:5 
task can issue a $SWSTK macro to change from user- to system=-state. 
This allows the task to access the Executive or system code without 
interruptions or fear of the data being changed while it is being 
accessed. See S$SWSTK in an Unmapped System or SSWSTK in a Mapped 
System in this chapter. 


4.2.3 Writing a Privileged Task 


In addition to the privileged task mapping and cautions mentioned 
previously, take note of the following points when writing a 
privileged task: 


l. Task size is limited to 8K if you have a 20K Executive and 
12K if you have a 16K Executive. This limit occurs because 
only two APRs are available for mapping your task with a 20K 
Executive and three APRs with a 16K Executive. 


2. Your privileged task is mapped with the Executive and I/O 
page. This mapping is done to allow your task to access the 
Executive and I/O page registers (APRs, device registers, 
etc.). You can refer to any area in the Executive or I/0 
page by label or label and offset because you task build your 
task with the Executive symbol table file and library. A 
typical Task Builder command file is, for example: 


PRIV/PR:5,PRIV/-SP=PRIV 
[1,54] RSX11M.STB, [1,1] EXELIB/LB 
/ 


UNITS=1 ;DEFINE NUMBER OF LUNS 
GBLDEF=OUTLUN:1  ;DEFINE LUN ON WHICH TO PRINT MESSAGES 
ASG=TI0:1 ;ASSIGN LUN TO DEVICE 


In this command file, the Task Builder is informed that the 
task has a privilege attribute of 5. Therefore, the task 
uses APR 5. It also uses APR 6 if it is over 4K in length. 


3. When you use a privileged task, the Executive has dedicated 
almost all the APRs to the necessary mapping for the 
Executive, the I/O page, and your task. Your task can issue 
PLAS directives to remap any number of these APRs to regions. 
However, such remapping can cause obscure and difficult to 
find system bugs. Also, be aware that when a directive 
unmaps a window that formerly mapped the Executive or the I/0 
page, the Executive restores the former mapping. 
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4. A privileged task uses the $SWSTK macro when going from user- 
to system-state. (See S$SWSTK in a Mapped System.) While in 
system state your task can access the Executive and I/O page 
without being interrupted by other tasks or system processes. 
It would be prudent to limit the time that your task spends 
in system state for the sake of other system users. Remember 
that while in user-state your task can not only read, but 
change the Executive or I/O page, if necessary. However, if 
your task is interrupted while changing data in user state, 
it may not finish its processing properly, thereby causing 
obscure bugs. Allowing a task to manipulate’ the Executive 
data base while in user-state is not a goal of RSX-11M. 
Future releases of RSX-11M may prohibit this activity. 


5. While in system-state, a privileged task can modify any 
mapping registers to make them point to any desired area of 
physical memory. For example, the system task, PMD, loads 
the starting address of the task being dumped into KISAR6 
(Executive APR 6). It then biases the addresses by 140000 to 
force mapping through APR 6. The bias is 120000 for APR 5. 
Note that by modifying APR 5 or APR 6 registers, it is 
possible for a privileged task to unmap its task image. 
Therefore, you must take care to avoid this. However, PMD is 
only 4K words in size. Therefore, modifying KISAR6 cannot 
cause PMD to unmap itself. 


4.2.4 The $SWSTK Routine Described - Unmapped and Mapped Systems 


4.2.4.1 SWSTKS in a Mapped System 


SWSTKS - Used by privileged tasks to switch from user- to system-state 
(described for a mapped system). 


1. | TASK CODE EXPANDS TO: SYSTEM STACK 


CALL SWSTKS ,100$ CALL SSWSTK,100$ TASK PC 
Pee EMT 376 
ee ~WORD 100$ TASK PS 
Pera PROCESS: 
re EMT puts current PS 
eee and PC on stack, loads 

RETURN PC from location 30 
100S:... (SEMTRP) and PS from 


location 32 (PR7 - 
defined as 340). Cur- 
rent PC points to .WORD 
containing address of 
100$:. EMT in a mapped 
system causes switch 

to system SP. 


2. | DRDSP | 


SEMTRP: :DIRSVS 
TST S$STKDP 


co SYSXT 


SDIRSV::MOV R4,-(SP) 
DEC $STKDP 


MOV SP,@SHEADR 
MTPS #0 

MOV R3,~(SP) 
MOV R2,-(SP) 
MOV R1,-(SP) 
MOV RO,-(SP) 
CALL (R5) 

BR $DIRXT 


4. DRDSP 


SEMTRP: :DIRSVS$ 

—=TST SSTKDP 
BNE 708 
MOV @SHEADR,R3 
CMP (R3)+, (R3)+ 
MOV (R3)+,R5 
MFPI -—(R5) 
CMP #104377, (SP) 
BNE 808 


80$:CMP (R5) , #104376 
JMP $SWSTK 


85$:JMP SEMSST 


PRIVILEGED TASKS 


PROCESS EMT 376: SYSTEM STACK 
EXPANDS 10: ae 
JSR R5, SDIRSV 

Puts R5 on stack. TASK PC 

R5 then contains 


TASK PS 


return address of 
the TST instruction. 
Jumps to SDIRSV:: 


PROCESS: SYSTEM STACK 
Save R4 on stack. 
Decrement $STKDP. 
Stack depth: user- or 
system-state; 
1=USER, 0 or less = 
SYSTEM. Save current SP 
(->). 
MTPS expands to: 
CLRB @#PS 
Clears first byte of PS 
to allow interrupts. 
Save R3 through RO 
on stack. 
CALL (R5) expands: 
JSR PC, (R5) 
Puts PC on stack. 
Puts return address in 
R5 into PC. Jumps to 
TST following SEMTRP::. 


(R3) 


a | 


TASK PC 
TASK PS 


PROCESS: SYSTEM STACK 


Check for 0 SSTKDP. 

If not 0, crash. 

Get saved task SP into R3. 
Point to task PC in stack. 
Get address of word after 
SSWSTK into R5. (PC saved 
on stack after S$SWSTK in 
task. Back up R5 to 

check EMT. Check EMT. 

If EMT 376, jump to SSWSTK. 
If not, process SST. 


TASK PC 
TASK PS 


* Task stack pointer (R3) shown at this point. 


5. SYSXT 


S$SWSTK:CLRB (R3) 

MOV #KISAR6,R5 
MOV UISAR6, (R5) 
MOV UISARS,-(R5) 

(16K cond)MOV UISAR4,-(R5) 
MOV -~(R3),R5 
MOV (R5)+, (R3) 
MOV RS, (SP) 
MOV -(R3),R5 
MOV 12(SP) ,R3 
CALLR @(SP) + 


6. TASK CODE 


CALL SWSTKS ,100$ 
alge @¢ 6 6 
RETURN 
1008: 


7. SYSXT 


BR SDIRXT 


SDIRXT::MTPS #PR7 
MOV TERED: R3 
BNE 
MOV $ROSCH, R5 
BNE 
MOV (SP) +, RO 


MOV (SP)+,R3 
INC $STKDP 
MOV (SP) +,R4 
MOV (SP)+,R5 
RTI 


\ 


PRIVILEGED TASKS 


PROCESS: : SYSTEM STACK 
Clear byte 0 of task's PS word. 
Move user APRs to Executive 
APRs. Move user APR 4 if 16K 
Executive. Get saved task SP 
for PC. Put PC for return 
to user task in R3. Put 
task PC on system stack. 
Restore R5. Restore R3. 
CALLR expands: 
JMP @(SP)+ 
Return to task instruc- 
tion after S$SWSTK to pro- 
cess system—-state code. 


TASK PC 
TASK PS 


TASK PROCESS: SYSTEM STACK 


Do system-state proces- 

sing. RETURN expands: 
RTS PC 

Pops stack and gets 

saved PC to go back to 

SYSXT at BR S$DIRXT 


instruction. 
TASK PC 
TASK PS 
PROCESS: 


Lock out interrupts. 
Check forking. 

Check rescheduling. 
Restore RO - R3. 

Make S$STKDP = l. 

Restore R4, R5. 

RTI pops saved PC and PS. 
from stack. 


8. TASK CODE 


PRIVILEGED TASKS 


PROCESS: 


SAVED PC ——™,WORD 100$ Process at 100S in 


100$: code 


user-state. 


4.2.4.2 SWSTKS in an Unmapped System 


SWSTKS - Used by privileged tasks to switch from user- to system-state 
(described for an unmapped system) 


i. [ zas cone | 


CALL SWSTK$,100$ 


RETURN 
100S:... 


2. DRDSP 


SEMTRP: :DIRSVS 
TST S$STKDP 


3. | SYSXT | 


SDIRSV::MOV R4,-(SP) 
DEC SSTKDP 
MOV SP,@SHEADR 
MOV #SSTACK,SP 
MTPS #0 
MOV R3,-(SP) 
MOV R2,-(SP) 
MOV R1,-(SP) 
MOV RO,-(SP) 
CALL (R5) 

* BR SDIRXT 


EXPANDS TO: 


CALL S$SWSTK,100$ 
EMT 376 
-WORD 100S 


PROCESS: 

EMT puts current PS 

and PC on stack, loads 
PC from location 30 
(SEMTRP) and PS from 
location 32 (PR7 - 
defined as 340). Cur- 
rent PC points to .WORD 
containing address of 
100$:. Still using user 
SP at this point. 
Switch to system SP. 


PROCESS EMT 376: 


EXPANDS TO: 

JSR R5, $DIRSV 

Puts R5 on stack. 

R5 then contains 
return address of 
the TST instruction. 
Jumps to S$DIRSV:: 


PROCESS: 


Save R4 on stack. 
Decrement SSTKDP. 
Stack depth: user- or 
system-state; 
1=USER, 0 or less = 
SYSTEM. Save current SP 
(->). Load system SP. 
MTPS expands to: 
CLRB @#PS 
Clears first byte of PS 
to allow interrupts. 
Save R3 through RO on 
system stack. 
CALL (R5) expands: 
JSR PC, (R5) 
Puts PC for return 
to BR $DIRXT (*) for system 
exit. Puts return address 
in R5 into PC. Jumps to 
TST following SEMTRP::. 
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USER STACK 


TASK PC 


TASK PS 


USER STACK 


TASK PC 
TASK PS 


STACKS 
USER SYSTEM 


ee 


PRIVILEGED TASKS 


4. DRDSP PROCESS: 


SEMTRP: :DIRSVS 
—— wm TST SSTKDP Check for 0 SSTKDP. 
BNE 70$ If not 0, crash. 
MOV @SHEADR,R3 Get saved task SP into R3. 
CMP (R3)+,(R3)+ Point to task PC in stack. 


* MOV (R3)+,R5 Get address of word after 
CMP #104377,-(R5) SSWSTK into R5. PC (R3) => 
BNE 8008S: saved on stack after SSWSTK 


in task. Back up R5 to 
80S:CMP (R5),#104376 check EMT. Check EMT. 
JMP $SWSTK If EMT 376, jump to SSWSTK. 
85S:JMP EMSST If not, process SST. 


* User stack pointer (R3) shown at this point 


5. SYSXT PROCESS: 


SSWSTK:CLRB (R3) Clear byte 0 of task's PS 
MOV -(R3) ,R5 word. Get saved task SP 
MOV (R5)+, (R3) for PC. Put PC for return 
MOV R5,-(SP) to user task in R3. Put task 
MOV -(R3),R5 PC on system stack. Restore 
* MOV 12(SP),R3 R5. Restore R3. CALLR 
CALLR @(SP)+ expands: JMP @(SP)+ 


Return to task to 
instruction after 
SSWSTK to process 
system-state code. 


* System stack pointer shown at this point 


6. | TASK CODE TASK PROCESS: 


CALL SWSTKS ,100$ Do system-state processing 
—— ee RETURN expands: 
avait . RTS PC 
eee Pops stack and gets 
* RETURN saved PC to go back to 
100$; SYSXT at BR SDIRXT 
instruction, 


* System SP shown at this point 


STACKS 
USER SYSTEM 


=e 


STACKS 
USER SYSTEM 


Tae fanse = 
Ts [oe 
[ase re] a 

a 


STACKS 


USER SYSTEM 


Tw [ee 
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7. 


| SYSXT | 


BR $DIRXT 


SDIRXT::MTPS #PR7 
MOV $FRKHD,R3 
BNE 
MOV 
BNE 
MOV 


$RQSCH, RS5 


(SP) +,R0 


(SP)+,R3 
@S$HEADR,SP 
SSTKDP 
(SP) +,R4 
(SP)+,R5 


MOV 
MOV 
INC 
MOV 
MOV 
RTI 


8. | TASK CODE 


SAVED PC —.WORD 1005S 
100$: code 


4.2.5 Task Mapping 


Figure 4-1 shows 
unmapped system. 


the mapping 


Figure 4-2 shows 
system. 


the mapping 


Figure 4-3 shows 
system. 


the mapping 


Figure 4-4 shows the mapping 


PROCESS: 


Lock out interrupts. 
Check forking. 

Check rescheduling. 
Restore RO - R3. 

Restore RO - R3. 

Reload user SP. 

Make S$STKDP = l. 

Restore R4, R5. 

RTI pops saved PC and PS. 
from stack. 


PROCESS: 


Process at 1005 in 
user-state 


of a nonprivileged user task 


of a nonprivileged task in a 


of an 8K nonprivileged task in a 


of an 8K nonprivileged task th 


memory management (PLAS) directives in a mapped system. 


Figure 4-5 shows an 8K privileged task mapped into APRs 5 and 4. 


20K Executive occupies 5 


privileged task and one for the I/O page. 
this example. 
the Executive's own APRs (KISARO through KISAR4, 
normally the user APRS (UISARO through UISAR4, and UISAR7). 


the system in 


is 


leaves two APRs 
All the APRs are 
The Executive copies what are 
and KISAR7) 


APRs, which 


in an 


mapped 
mapped 
at 


uses 


The 
for the 
used by 
normally 


into what 


Thus, 


the privileged task has access to the Executive and I/O page in either 


user~- or system-state. 


These figures are presented in a sequential and logical way 


t 


ro) allow 


an easier understanding of privileged task mapping in the system. 


PRIVILEGED TASKS 


TASK VIRTUAL 
ADDRESS SPACE 


PHYSICAL MEMORY 


177777 


170000 


Location of task depends on partition location in unmapped system (PAR option of TKB) 
Base of task on 32-word boundary; length is a multiple of 32 words; highest virtual address = 28K 
Non-runable task — resident library or global common — maximum size = 32K minus 32 words 


Unless you change parameters of task and task build again, task in unmapped system always loads into 
the same location 


INSTALL calls $ALOCB to allocate TCB space. It then reads the first record of header label blocks, and 
sets up data in the task header. It verifies that the task fits in the specified partition 


INSTALL sets load device and LBN in TCB. UCB address of load device is put in header of INSTALL asa 
result of opening task image file. It then puts UCB address in TCB of task 


INSTALL: checks System Task Directory (STD) for task of same name; gets partition name from task 
Label Block Group; searches for task partition; checks if task fits in partition 


INSTALL: checks Label Block Group for PLAS support, resident overlays; puts task offset in TCB, checks 
if task is acommon block, checkpoint file space, set priority in TCB, checks partition base address and 
task starting address . 


INSTALL fills in TCB with information from Label Block Group. When everything is done, TCB is in 
STD 


When the task is executed, the Executive Loader loads task into correct partition and location. TCB is 
put on Active Task List 


Figure 4-1 User Task in Unmapped System 
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oO - Nw fF ABN 


PRIVILEGED 


TASK VIRTUAL e 
ADDRESS SPACE 


007777 


PHYSICAL MEMORY 


4K USER TASK 


72040 MOV LOC, R1 


67777 


EXECUTIVE 


Figure 4-2 4K Nonprivileged User 
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TASKS 


Nonprivileged user task uses User Active Page 
Register 0 (APR 0), which is called UISARO in 
the |/O page. 


User is aware of virtual addresses 0 - 07777, 
only. 


INSTALL task maps this 4K task with APR 0 
only, because task is only 4K. If it were bigger, 
INSTALL would select needed number of 
APRs (4K for each of 8 APRs — 32K maximum). 
INSTALL determines into which partition task 
is to go in mapped system and virtual address 
for base of task (task may have a virtual section 
at beginning of task code, making its real virtual 
address different from its apparent virtual 
address). Executive determines physical address 
by information in task header and current sys- 
tem memory allocation. Executive puts this 
address in APRO. After task is loaded, mapping 
information is kept in Executive copy of task 
header in DSR. 


Contents of APR 0 relocates whole task (MOV 
instruction shown as part of task as an example). 


Bits 13-15 of task virtual address selects APR 0. 
\f task were 8K, two APRs would be used. 
Virtual addresses in the task (bits 13-15) select 
dynamically the APR from those assigned. 


KT-11 adds value in APR O (16 bits) to bits 
6-12 of virtual address. KT-11 appends sum to 
the low-order 6 bits of the virtual address to 
produce 22-bit physical address. 


Task Mapping in a PDP-11/70 


PRIVILEGED TASKS 


TASK VIRTUAL 
ADDRESS SPACE 


37777 


o-~=~ nN DPF t_a~ 


21 22-BIT PHYSICAL ADDRESS 0 


121770 


@ User task shown has no memory management 


directives. 


e@ User task is 8K in size. Because each APAR 


maps 4K of memory, user task must use two 
APARs. 


For example, APR 1 relocates address 21770 

in the user task to physical address 121770. 
Because the virtual address being translated is 
over 4K and less than 8K, the high-order three 
bits of the address are 001. The three high-order 
bits select APR 1. If the task were between 

8K and 12K in size, virtual addresses between 
8K and 12K would contain 2 in the high-order 
digit and APAR 2 would be selected for these 
addresses. This relationship of virtual addressing 
to APRs continues up to 32K of virtual addresses. 
Each APAR can contain a 4K relocation factor; 
therefore, with 8 APARs, 32K of virtual 
addresses can be relocated. 


The virtual address limit of a user task in a 
mapped system is 32K. 


Without memory management directives, user 
task without commons or resident libraries 
occupies continuous physical address space in 
memory. The task can only access that physical 
memory to which the Executive maps it. This 
physical memory is continuous and has a direct 
one-to-one relationship to the tasks’s virtual 
addresses until the task exits or the Executive 
checkpoints it. Of course, the Executive does 
not move fixed tasks once they are loaded, but 
they may be shuffled. 


Executive memory allocation routines determine 
the physical base address of the user task when 
the Executive Loader loads the task into mem- 
ory. The base address is likely to change if 
checkpointing or shuffling occurs. 


Figure 4-3 8K Nonprivileged User Task Mapping in a PDP-11/70 


PRIVILEGED TASKS 


8K TASK 
VIRTUAL ADDRESSES 
17777 


TASK DATA 


07777 F 


TASK ROOT 
AND HEADER — 
APRO 


KT-11 MEMORY MANAGEMENT UNIT 


APRs (UISAR 0-7) 18 12 65 2 


|_| VIRTUAL ADDRESS = 


eee ee ge ee ee ee 


! 
| 
1 
2 | 
L 


5 6 
' oy, 
22-BIT PHYSICAL ADDRESS Fd Q 


PHYSICAL MEMORY 


ny 


8K REGION (COM1)} 


CURRENT MAPPING 
BY MAP ADDRESS WINDOW 
DIRECTIVE 


4K TASK ROOT 
AND HEADER 


GEN 
Partition 


j EXECUTIVE 


@ The Task Builder built this task with WNDWS 


option = 1; the Task Builder reserves two win- 
dow blocks in Task Header. Window blocks 
contain mapping information (see Chapter 2). 
Window block 0 is for APR 0 mapping. TKB 
always reserves one window block (window 0) 
for mapping task header and root (in this case 0 
to 7777). Window block 1 is for address win- 
dow (APR 2} that PLAS directives use in the 
task. However, a task may use more than one 
address window for mapping when using PLAS 
directives, but the number of windows to be 
used must be specified to TKB when building 
the task. 


Upper 4K of this task is defined as an address 
window to access a region in memory. 


Window size can be 32 to 32K minus 32 words 
and must start on a 4K virtual boundary. 


The Executive maps both the task root and the 
region into the GEN system-controlled partition. 
You must specify the APR that the Executive 

is to use for the region. 


The Executive may map the region to a numeri- 
cally lower physical location than your task and 
the region and task root may or may not be con- 
tiguous in memory. 


You must create Window Definition Block 
(WDB) in your task (see Chapter 2 or RSX-11M 
Executive Reference Manual). 


You must create the Region Definition Block 
(RDB) in your task (see RSX-11M Executive 
Reference Manual). 


Your task must issue an Attach Region directive 
to attach the region (COM1) to your task. 


Your task must issue a Map Address Window 
directive to map your task’s window to the 
region. In this directive, your task specifies the 
offset into the region in which mapping begins. 
This offset can be changed by issuing another 
Map Address Window with the offset changed. 
Doing this can move the window through the 
whole region. 


These directives in combination with the Send/ 
Receive and Detach Region directives make it 
possible for two tasks to transfer data to each 
other through a region that they can both access 
in common. 


Figure 4-4 8K Nonprivileged Task Mapping 
in a PDP-11/70 Using PLAS Directives 
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Figure 4-5 Privileged Task Mapping 


CHAPTER 5 


MCR INTERFACE 


5.1 MCR - MONITOR CONSOLE ROUTINE 

MCR is the collection of functions that make it possible to operate 
and control the RSX-11M system from a terminal device. As the link 
between the collection of services provided by RSX-11M and users who 
want to make use of these services, MCR provides a number of commands 
which you can execute by entering the command at your terminal. 


The RSX-11M Operator's Procedures Manual describes all the MCR 
commands that you can use. They are listed as follows: 


1. ABOrt 
2. ACS 
. ACTive 
- ALLocate 


- ALtTer 


3 

4 

5 

6. ASsigN 
7. ATL 

8. BRK 

9. CANcel 

10. CLQueue 
ll. DEAllocate 


12. DEVices 


13. FIX 
14. HELP 
15. LUN 


16. OPEn register 
17. PARtition definitions 
18. REAssign 


19. REDirect 
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20. REMove 


21. RESume 
22. RUN 
23. SAVe 
24. SET 


25. TAsk List 
26. TASk list 
27. =TIMe 
28. UNFix 
Services 29-39 run as tasks. 
29. BOOt 


30. BROadcast 


31. BYE 
32. DMOunt 
33. HELIo 


34. INTitvolume 
35. INStall 


36. LOAd 
37. MOUnt 
38. UFD 
39. UNLoad 


5.1.1 Structure and Operation Environment of MCR 


MCR is an RSX-ll1 task that, typically, operates out of its own 
partition. MCR runs at a moderately high priority to be able to 
service terminal input requests. This priority value is typically 
160. or, at least, higher than that of user tasks and utilities. MCR 
is privileged and is usually stopped, though active, while waiting for 
terminal input. MCR can be checkpointed and have checkpoint space in 
its own task image. 


MCR is a tree structured task, and its structure is depicted 
schematically in Figure 5-l. 


ROOT 
an) ne ao ele 
DISPATCHER PARSERS (1-3) COMMAND FUNCTION PROCESSORS 


Figure 5-1 MCR Tree Structure 
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The command function processors are those that process the first 16 
console services listed in Section X.xX. The remaining console 
services run as tasks and not as integral parts of MCR. MCR, in fact, 
does not distinguish between these task functions and tasks that it 
initiates as a result of recognizing -an MCR reguest for functions 
17-22 listed in Section 5.1. The console language syntax is defined 
such that if the first three characters of an input line are not part 
of the defined command language, then MCR attempts to initiate the 
task named 


a KXX 

Thus, the task named ...JIM can be initiated by entering 
JIM 

to MCR, or by entering 
RUN ...JIM 


to MCR. 


5.1.2 The Terminal Driver and MCR Initiation 


The terminal driver is intimately integrated into the operation of 
MCR. Because RSX~-11M accepts and acts upon unsolicited input from any 
operator terminal, it is the function of the terminal driver to know 
when it is receiving input destined for MCR. 


When a character on an operator terminal is struck, the resulting 
interrupt initiates the terminal driver. (Remember the device is full 
duplex and the keyboard cannot be locked to prevent input when the 
device is, in fact, involved in an I/O operation.) The driver then 
acts on the input as follows: 


1. [Check the device state] 
Is the device busy. No, go to 3. 
2. [The device is busy] 


If the driver was sending output (in an output state) when 
the character was entered, an input request flag is set in 
the appropriate UCB and the driver continues sending the 
output stream. When the output reguest is finished, 
processing continues at 5. 


If the terminal was in an input state. the character is 
accepted. Go to 6. 


3. [Device is not busy] 


Note, if the device was not busy, the incoming character is 
the first character of an input line. 


Was the input character a CTRL-C? (CTRL-C is an explicit 
reguest to communicate with MCR.) If the character was a 
CTRL-C, the terminal driver executes a $FORK and execution 
continues at 4. 
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If the first character is not a CTRL-C, a check is made to 
see if the device is attached. If it is, MCR ignores the 
character (unsolicited input to MCR on an attached device is 
not permitted). 


If the device is unattached then it is considered the 
beginning of unsolicited input to MCR. Go to 4. 


[Fork level processing] 


The driver has transferred to fork level because it needs a 
buffer, and it can only get a buffer at fork level (shared 
system tables must be altered to obtain a buffer). In 
addition to getting a buffer, the fork level terminal 
processing code must check for a rare race condition. 


After the arrival of the CTRL-C (or a non CTRL-C character if 
the terminal is not attached) and between the time the fork 
is executed and control is regained in the driver, it is 
possible that the device may have returned to the busy state. 
This is because we may have just unbusied the device for a 
previous request when the input interrupt occurred. The 
interrupt code finds the device free and executes a fork. 
But before control is regained at fork level, execution is 
continued in the driver for the previous request. The driver 
jumps to the initiator entry to propagate its execution and 


_thus may find another waiting I/O request which it begins 


processing because the device is free. Thus the fork routine 
Must recheck the state of the device. If it is busy the 
input is ignored and the driver returns (exits) from fork 
level. Otherwise, an attempt is made to obtain a buffer for 
the unsolicited input. 


{Buffer Acquisition] 


“I£ the buffer acguisition attempt is unsuccessful, the driver 


ignores the input and exits. 
If a buffer is obtained, the driver sets up to start an 
unsolicited input reguest by initializing various pointers 
and setting the status of the controller and unit to busy. 

If the initial input character was CTRL-C, then 

MCR> 


is echoed to signify an explicit request to input to 
MCR. 


Otherwise, the input character is stored in the buffer 
and echoed on the initiating terminal. 


The driver returns (exits) from fork level. 
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6. [Character processing] 


Once the terminal driver determines that input coming from an 
operator terminal is destined for MCR, it transfers 
subsequent characters into the buffer acguired in Step 5. It 
also echoes the incoming characters. The acceptance of input 
ceases if: 


a. The buffer is filled (the buffer has room for 80 
characters) but the maximum accepted depends on the 
device: 


72 for KSR 

72 for VTO5B 
80 for LA30S 
80 for LA30S 


b. An end of line character is entered. The valid end of 
line characters are: 


CTRL-Z 

Carriage Return 

ALT-Mode (codes 33, 175, and 176) 
7. (Interrupt from a character echo] 


Is the device in input mode? If it is not, another character 
is obtained from the user output buffer and it is echoed. If 
the device is in input mode, end-of-line must be checked. If 
it is not, the keyboard interrupt is re~enabled and exit from 
the interrupt occurs. If end-of-line is detected, then the 
fork process is called. 


8. [End-of-line processing - fork level] 


For unsolicited input, the UCB address and the terminating 
character are deposited into the input buffer and the buffer 
linked into MCR's input gueue. MCR is then requested to run. 
The driver itself clears control and unit busy and returns to 
its initiator entry point. 


For solicited input, I/O Done is called. First, the number 
of characters entered is determined and the buffered input is 
moved to the soliciting task's input buffer. The driver 
input buffer is released and I/0 Done is called with the 
second I/O status word equal to the number of bytes entered. 
The left byte of the first I/O status word is set equal to 
the terminating character and the right byte to +l. The 
driver then jumps to the initiator entry point to propagate 
its execution. 


5.1.3 MCR Operation 


After the reguest of MCR by the driver, the file system is swapped out 
and MCR is swapped in. Control is passed to the MCR root segment 
which calls the Dispatcher (DSPTCH) overlay. DSPTCH, via a privileged 
subroutine (SSWSTK), switches to system state. The call to this 
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routine includes a parameter which is the address where the caller 
wants to return when it switches back to task state. The state 
switching routine performs the switch and resumes processing in the 
caller immediately following the call. When SSWSTK is called, it sets 
up an interrupt entry to the system. Interrupts are locked out while 
it pushes the passed return address and the PS on the stack. SSWSTK 
then calls interrupt save ($INTSV). On return from interrupt’ save, 
R3, R2, Rl, RO are pushed onto the stack and now the stack state 
Simulates that of an EMT. $SWSTK now calls the caller who resumes 
execution one instruction past the call to $SWSTK. When the calling 
routine finishes, it returns, which takes it back to SSWSTK. SSWSTK 
jumps to Directive Exit which redispatches the processor. The effect 
of this is to resume the caller in task state at the passed return 
address. 


MCR now proceeds as follows: 
1. [Request an unsolicited input gueue entry] 
The Dispatcher calls the queue removal routine (SQRMVF). 
SQRMVF attempts to remove a buffer and deliver it to the 
Dispatcher. If no buffer is available (carry set return from 


SQRMVF) the Dispatcher exits. The buffer is formatted as 
shown in Figure 5-2. 


——— WORD ————"— WORD ————=—- UP TO 80 BYTES > 


LINK TO UCB OF COMMAND INPUT 
NEXT BUFFER | INPUT DEV 


Figure 5-2 Input Buffer 


The gueue empty condition never occurs on an initial call to 
MCR, because MCR is not requested unless something is in the 
queue. MCR remains resident until it has processed all the 
entries in the unsolicited input queue. 


Note that the Dispatcher, during buffer requisition, is 
operating at system level and all queue entries are done at 
fork level. Thus the buffer removal process is linearized 
with buffer item entry. 

If DSPTCH gets a buffer, it saves the buffer address in a 
memory location and does a return. This return takes DSPTCH 
back to task state where the processing of the buffer begins. 

2. [Process a Buffer] 


On return to task state, the Dispatcher scans through the 
buffer and 


1. Compresses out redundant spaces and/or tabs 
2. Converts an Escape character to a Carriage Return 


3. Truncates trailing spaces and/or tabs 
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If no line terminator is found in the buffer, the Dispatcher 
inserts aCR as the 80th character. Finally the actual line 
terminator (either CR or ESC) is saved so it can be restored 
in the message if the message must be routed to a task other 
than MCR itself. 


The Dispatcher then converts the first three characters to 
RAD50 and begins to search two internal tables for an MCR 
function with a matching name. 


(Searching the function tables - Table descriptions] 


MCR has two function tables; one for privileged commands, 
and one for non-privileged commands. 


Privileged commands are those whose unrestricted use could 
cause privacy violation or system failures and they can only 
be executed from a privileged terminal. Privileged terminals 
are identified by a bit in the UCB. These terminals are 
established at SYSGEN or by the SET command. 


Both tables contain a 5-word packet for each command in the 
class (privileged or non-privileged). The packet appears in 
Figure 5-3. 


RAD50 CMD NAME (3 CHARS) 


INDEX INTO COMMAND OVERLAY 
ADDRESS OF PARSER TABLE 
RAD50 COMMON OVERLAY NAME 


INDEX INTO COMMON OVERLAY 


Figure 5-3 Function Table Entry 


The table entries correspond to three overlay types: 

1. Command overlay 

2. Parser overlay 

3. Common overlay 

The use of these overlay types is noted next. 

Typically, any command that can be processed in a_ single 
overlay and whose size is such that it reguires all or nearly 
all of the max overlay size (600 wds) is classed as a command 
overlay. 

Parsers for the commands are distinct entities and are 
grouped into overlays. Generally, a given parser services 
more than one command but three parsers currently service all 


the commands. The parser entry is a pointer to a parser 
table entry shown in Figure 5-4. 
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RAD50 PARSER NAME (3~-CHARS) 


INDEX INTO PARSER OVERLAY 
Figure 5-4 Parser Table Entry 


Because three parsers service all the commands it is more 
economical in storage space to point to the parser table than 
to include the name and the index in the main function table. 


The index is used as the entry point into the parser where 
the parsing for a given command begins. This is required 
because a parser can, and generally does, contain parsers for 
more than one command. 


The common overlay is used when the processing for a command 
is small enough to make it practical to group more than one 
command into a single overlay. This grouping saves space 
since ten words are reguired by the Overlay Runtime System 
for each overlay in a tree structure. The index serves’ the 
same purpose as the index in a parser overlay. 


Note that a command overlay also contains an index. The 
value of the command overlay index is generally zero. But to 
maintain the coherence of the table processing commonality, 
and to allow for flexibility, the index is included. 


[Look up and start a function other than an MCR internal 
function] 


The Dispatcher then looks in the privileged command table for 
a name which matches the first three characters in the input 
buffer. This table contains all the privileged MCR commands. 


Internally, privileged terminals are identified by a bit in 
the UCB. The bit is set at SYSGEN or from a privileged 
terminal using the SET MCR command. 


If the command is not found in the privileged command table, 
the non-privileged command table is searched. 


MCR for multiuser-systems is called MCRMU. MCRMU is actually 
two tasks: »»-MCR and ...SYS. The Dispatcher in MCRMU, 
which is part of the MCR task, looks in a table to see if it 
igs to process the issued command. These commands are: LUN, 
REA, REM, FIX, UNFIX, CANCEL, RESUME, and ABORT. If the 
command is not in this table, the Dispatcher looks in another 
table to see if the task, ...SYS, processes the command. 


If the name is not in either table, then the Dispatcher 
prefixes three periods to the three buffer characters, and 
using these six characters, searches the STD looking for a 
match on the name. If it does not find the name it displays 
an error message on the initiating terminal. If it finds the 
name, it requests the function to run, supplying as an 
argument to the requested task the UCB address that was in 
the input buffer. The UCB address is inserted into the TCB 
of the requested task as its TI (terminal input) pseudo 


3b. 


3G. 


3d. 
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device. If the attempt to reguest the task fails, an error 
message is displayed, the buffer is released, and MCR exits. 
Having discovered a non-internal MCR function, MCR must 
prepare to pass the buffer, because the initiated task is 
going to issue a Get MCR Command Line directive. To pass the 
buffer, MCR uses three words in system common. These words 
ares 


1. The TCB address of the requested task 
2. The address of the command buffer 


3. The byte count of the number of input characters in the 
buffer 


MCR fills these words, making synchronizing checks that they 
are free, because only one triplet exists for passing buffers 
to a requested task. Thus, until the buffer is emptied, 
other completed buffers in the gueue are waiting. 


Eventually, the requested task starts running, and issues a 
Get MCR Command Line directive. The directive processing 
then tests for a match on the TCB address in SYSCM and the 
TCB address of the requesting task. If they match the buffer 
is passed to the task by copying it into the DPB of the 
directive. The directive status is set to the byte count, 
the buffer is released and the TCB address in the SYSCM 
triplet is cleared. The TCB address being zero is an 
indication to MCR that the triplet is free. 


[Start an internal MCR function] 


Once a name match has been found in the. command table, the 
Dispatcher copies words 1, 2, 4 and 5 of the function table 
entry and both words of the parser table entry for this 
command into the MCR root segment. Now the Dispatcher scans 
the function table entry as follows: 


If a parser exists, go to 4. Otherwise, if a command overlay 
exists go to 3d. If a command overlay does not exist, go to 
5. Otherwise, abort the system. 


The Dispatcher forms the overlay name, constructs the 
reguired overlay information packet, and enters the root at 
the point where overlay loading is performed. 


{Parser functions] 


The selected parser parses the buffer and, if the parse is 
successful, it jumps back to the root to load the desired 
function. If the parse fails, the parser deposits an error 
number in the root and jumps to the entry SERLD in the root 
which loads the error overlay. 


Ultimately the root initiates another routine, either the 
error routine or the requested function. 


{Function routines] 


These routines may further check the input and find errors. 
If errors are found, the function sets up the error routine 
and jumps to the root to load an error overlay. If it 
succeeds, the function releases the buffer and enters the 
root as the point where the root reloads the dispatcher. 
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[Error Overlay] 


The error overlay contains all error messages and the code 
needed to format the error message from the error number 


deposited in the root by the MCR component discovering the 
error. 


{Final Exit] . 


The dispatcher calls the queue routine to obtain another 
buffer; if one is found, the cycle of name table scanning 


resumes (starting at Step 2). If no buffers are waiting, MCR 
exits. 


CHAPTER 6 
I/O PROCESSING 


This chapter contains a description of QIO directive processing in the 
form of a Logical Flow Diagram. 


6.1 IMPLEMENTATION 


The user interface to the RSX-11M I/O system consists of logical unit 
numbers (LUNs) and aé_e single active I/O directive, Queve I/O. (The 
directives Assign LUN, Get LUN Info, etc. do not initiate I/0 
transfers.) 


In RSX-11M all the preliminary processing antecedent to actually 
queuing an I/O request is performed by the QIO directive processing 
code that uses the I/O data structures. This code calls ancillary 
routines for centralized services. When a driver finally receives an 
I/O order, it generally has very little to do other than set up the 
status registers and issue the order. 


Termination processing is equally modular and centralized. The driver 
is entered, performs some cleanup operations, and calls centralized 
routines for obtaining pending I/O orders, performing AST processing, 
etc. The driver is only concerned with the most intimate and specific 
details of the actual hardware interface in respect to the execution 
and completion of I/O transfers. Using this centralization 
philosophy, RSX-11M keeps both driver size and non-interruptible 
processing time small. 


6.2 RSX-11M I/O DATA STRUCTURES 
The static I/O data structures consist of three blocks: 
l. A Device Control Block (DCB) 
2. A Unit Control Block (UCB) 
3. A Status Control Block (SCB) 
Although each serves a specific function, and the components of each, 
in general, reflect these functions. The functional purpose of each 


data structure is reflected by the units of information which compose 
them. See Chapter 8, Data Areas and Control Blocks. 
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6.2.1 The Device Control Block (DCB) 


One device control block exists for each device type attached to the 
system. Its function is to describe the static characteristics of 
both the controller and the units attached to the controller. All the 
DCBs in the system are singly linked. The DCB contains such 
information as: 


e The device mnemonic (two ASCJI characters) 


e The lowest and highest unit numbers on the respective 
controller type 


e The address of the first UCB 

e The length of each UCB 

@ The next DCB pointer 

® The Legal Function Mask 

@e The Control Function Mask 

@ The No-Op'd Function Mask 

e The File Function Mask 

e The pointer to the Driver Dispatch Table 
For Loadable drivers, the pointer to the driver's driver dispatch 
table (D.DSP) and the pointer to the driver's PCB (D.PCB) are altered 
by Load and Unload. 
The rest of these information fields are static and are used 
principally by the Queue I/O directive processing code to prepare a 


Queue I/O request for a device driver. The details of Queue I/0 
processing are shown in Figure 6-2, QIO Directive Processing. 


6.2.2 The Unit Control Block (UCB) 


One unit control block exists for each physical device unit attached 
to the system. Many of its information fields are static and very 
device dependent. The device independent parts of the UCB contain few 
dynamic parameters. For example, the redirect pointer reflects the 
result of a Redirect MCR command. 


The UCB contains device unit specific data, such as unit status, 
physical unit number, and unit characteristics. See Chapter 8, Data 
Areas and Control Blocks. 


6.2.3 The Status Control Block (SCB) 


One status control block exists for each device controller in the 
system, This is true even if the controller handles more than one 
device unit (like the DK Controller). Line multiplexers such as_ the 
DH11 and DJ11 are considered to have a controller per line since all 
lines may transfer in parallel. 
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Some of the information in the SCB is dynamic. It contains the 
following information about the currently active unit: 

e The interrupt vector address 

@ The controller bus request priority 

@® Timeout counts (initial and current) 

@ The address of the Control Status Register 

@ The address of the current I/O Packet 

e Storage for a Fork Block 

e The I/O gueuve listhead 

@ The controller status (busy/idle) 

e The controller index 
The dynamic data in the SCB makes it possible to maintain control of 
the current I/0 in progress on the controller. The presence of Fork 
Block storage in the SCB implies that a driver cannot call $FORK twice 
for the processing at fork level on a given controller. The driver 
for a specific device type never concerns itself with unwanted 
recursion or multiple updates. Once a driver is in a fork level 
process, further I/O processing, which may involve updating a _ shared 


data base, is automatically locked out by the Fork processing of the 
system itself. ° 


6.3 QUEUE I/O DIRECTIVE PARAMETER BLOCK 


The Queue I/O directive requires a 12-word Directive Parameter Block 
(DPB) as shown in Figure 6-1. 


ee 


DEVICE 


DEPENDENT 


PARAMETERS 


Figure 6-1 Queue Directive Parameter Block 
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The parameters have the following interpretation. 
DPB size (required): 
The length of DPB in words. For QIO always egual to 12 words. 
DIC (required): 
Directive Identification Code. For QIO, the value is al. 
Function Code and Modifier (required): 
The code of the requested I/O function (0 through 31) and device 
dependent modifier bits. I/O function code definitions are in 
the RSX-11M I/O Drivers Reference Manual. 
Reserved: 
Reserved byte; must not be used. 
LUN (required): 
Logical Unit Number. 
Priority: 


Reguest priority. Ignored by RSX-11M, but space must be 
allocated for RSX-11D compatibility. 


EFN (optional): 
Event flag number. 
I/O Status Block Address (optional): 


This word contains a pointer to the I/O status block, which is a 
4-byte device dependent I/O completion data packet formatted as: 


Byte 0 

T/O status byte 
Byte l 

“Augmented data supplied by the driver 
Bytes 2 and 3 


The contents of these bytes depend on the value of byte 0. 
See the RSX-11M I/O Drivers Reference Manual. 


AST Address (optional): 


Address of an AST service routine. 
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Device Dependent Parameters: 


Up to six parameters specific to the device. These may be, for 
example: 


Buffer address 

Byte count 
Carriage control type 
Logical block number 


Any optional parameters that are not specified must be filled with 
zeros. 


Directive Parameter Blocks and their contents are fully described in 


the RSX-11M Executive Reference Manual and the RSX-11M I/O Drivers 
Reference Manual. 


6.4 QIO DIRECTIVE LOGICAL FLOW 


Figure 6-2 is a Logical Flow Diagram of QIO directive processing. The 
diagram shows the main stream of code flow through the DRQIO module of 
the Executive. 
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$DRQIO:: REFERENCES: 
—— ee  — — — (R3), (SP) 
SAVE 1/O FUNCTION CODE 
—_——-—---— — — $MPLUN, D.RSB 


CALL $MPLUN TO 
MAP LUN TO UCB 
ADDRESS. 

IF LUN NOT AS- 
SIGNED, SET D.RSS 


15$ 


1/0 OPERATION PENDING ON LUN ? PART 2 


Se ee — — — STKE 
GET SAVED TASK 
STACK POINTER. 
BACK-UP TASK PC 

TO RE-EXECUTE EMT. 
CALL $TKWSE TO 
WAIT FOR SIGNIFI- 
CANT EVENT. 


Figure 6-2 QIO Directive Processing (Part 1 of 24) 
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15$ 


IF DRIVER NOT 
RESIDENT, SET 
D.RS6. 


CALL $CEFN TO CONVERT 
EVENT FLAG NUMBER. 
CLEAR SPECIFIED 

EVENT FLAG. 


CALL. SACHKW TO 
CHECK 1/0 STATUS 
BLOCK ADDRESS. 

| CLEAR I/O STATUS BLOCK . 


CALL $ALPKT TO ALLOCATE 1/0 
PACKET AND CLEAR RECORD 
LOCKING ENTRY POINTER 


INCREMENT I/O 
REQUEST COUNT 


IF FUNCTION IS QIO 
AND WAIT, CALL 
$CEFI TO CONVERT 
FLAG TO MASK 
AND ADDRESS; 
CALL $DRWFS TO 
PUT TASK IN WAIT 
STATE. 


PART 3 


REFERENCES: 


_——— — — — — — — — D.RSE, D.DSP 


ee ee ee ee eee ae — SACHKW 


—-eeee----- $CEFI 
$DRWFS 


Figure 6-2 QIO Directive Processing (Part 2 of 24) 
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PART 2 


e REFERENCES: 


FILL IN I/O PACKET. 


— eae ae eee $RELOC 


CALL $RELOC TO 
RELOCATE I/O STATUS 
BLOCK ADDRESS. 


ia aes ee ae es SIOKIL 
IF FUNCTION IS I/O $DEPKT 
KILL, CALL $IOKIL SIOFIN 
TO FLUSH I/O QUEUE. 


SET SUCCESSFUL 
DIRECTIVE STATUS. 


— ——s ay a eee ae ee ee ce ce U.OWN, US.PUB, U.ST2 
IF FUNCTION NOT ap See T.UCB, T3.PRV, 
10 KILL, CHECK ' 
ACCESS RIGHTS 


TO DEVICE. 


IEPRI 
ACCESS ALLOWED? PART 12 
— eee oe ee a ee $BTMSK, D.MSK 
1EIFC 
ILLEGAL FUNCTION? PART 12 


PART 4 


Figure 6-2 QIO Directive Processing (Part 3 of 24) 
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PART 3 


REFERENCES: 


ewe ae ee ee ee oe oe os oe US OFL, U.ST2 


1EOFL 


IS DEVICE OFFLINE ? PART 12 


ISSUC 


1S FUNCTION NO-OP ? PART 12 


FCCTL 
CONTROL FUNCTION? ke. eee 


— eee ee I 


IS DEVICE MOUNTABLE? 80$ 
PART 6 
ee ee — — — = — US.MNT, US.FOR, 
1S DEVICE MOUNTED 60$ U.STS 
AND NOT FOREIGN? PART 5 


70$ 
ACP FUNCTION? py) PARTS 


SET UP TO EXECUTE CODE 


FOR SPECIFIC ACP 


PART 13 


Figure 6-2 QIO Directive Processing (Part 4 of 24) 


6-9 


I/O PROCESSING 


REFERENCES: 
' 60$ 
DEVICE {S NOT 
MOUNTED OR 
MOUNTED AS FOREIGN. 75$ 
PART 5 
ACP FUNCTION? 
FCTRN (PART II) 
(TRANSFER FUNCTION) 
70$ 
DEVICE MOUNTED AND 
NOT FOREIGN BUT NOT 
ACP FUNCTION 
LOAD OVERLAY FCTRN 
FUNCTION? PART 7 
i ain a hig pk a $TKTCB, T3.PRV, 
FCTRN T.ST3 
TASK PRIVILEGED? Saas 


IEPRI (PART 12) 
(PRIVILEGE VIOLATION) 


Figure 6-2 QIO Directive Processing (Part 5 of 24) 
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REFERENCES: 


DEVICE NOT 


MOUNTABLE. FCTRN 
PART 7 


ACP FUNCTION? 


THIS MUST BE A FILE 
STRUCTURED FUNCTION 
FOR A NON-FILE 
STRUCTURED DEVICE 
AND MUST BE A READ 
OR WRITE VIRTUAL. 
ALL OTHER FUNCTIONS 
WOULD BE ILLEGAL 

OR NO-OPS. 


— —— 10.RLB, I.FCN, 1.PRM 
ASSUME FUNCTION IS 
READ VIRTUAL 


—-—-— — — — — — — — 10.RVB 


IS IT READ VIRTUAL? FCTRN 
PART 7 


SET FUNCTION TO 
WRITE LOGICAL BLOCK 
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1/0 PROCESSING 


Ry REFERENCES: 
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FCTRN 
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ADORESS CHECK 
BUFFER. 

CHECK BUFFER 
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| 


IEBYT 
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ZERO LENGTH BUFFER? PART 11 


na eee eee $RELOC 


7 


CALL $RELOC TO 
RELOCATE USER 
BUFFER. 


VIRTUAL 1/0 208 
FUNCTION? PART 7 
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CALL $MPPHY TO MAP 
TO 18-BIT PHYSICAL 
ADDRESS. 
SET UP RELOCATION 
BIAS AND DISPLACEMENT 
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_ 


20$ 
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I/O PROCESSING 


PART 4 AND 11 
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I/O PROCESSING 
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Figure 6-2 QIO Directive Processing (Part 9 of 24) 


6-14 


I/O PROCESSING 


PART 9 
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I/O PROCESSING 


PART 10 
REFERENCES: 
ae es Be ee ees $MPLND 
CALL $MPLND TO MAP 
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ADDRESS. 
LOAD DEVICE MATCH lEOVR 
SPECIFIED UDB? PART 11 
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BLOCK NUMBER 
PART 8 
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BUFFER CODE PART 11 
co eer eee a ene lE.OVR 
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I/O PROCESSING 


REFERENCES: 
1EPRI 
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I/O PROCESSING 


REFERENCES: 
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MAPPING. RETRIEVE 
ADDRESS OF NEXT 
WORD IN DPB. 
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REFERENCES: 
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WORD IN I/O PACKET. 


—-— — — — — — — — — OPRM (PART 15) 
SET LENGTH OF 
FILENAME BLOCK 
AND CALL OPRM 
(PART 15) TO INSERT 
OPTIONAL FILENAME. 
BLOCK 


USE JMP @(R5)+ 
TO RETURN TO 
NEXT WORD IN 
VECTOR. 


FCDSP: 


ee ee a ew w= THIS DISPATCH VECTOR 
SEQUENCE USED BY: 
12 — UNLOCK BLOCK 


.WORD UNLXT 
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WORD. 


FILE ACCESSED ON {ENLN 
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I/O PROCESSING 


JMP@(R5)+ FROM CKNLN PART 17 
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UNLXT: 
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STACK, RESTORE R5. 


FCDSP: 
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I/O PROCESSING 


PART 18 


REFERENCES: 


FCCAW: .WORD CKALN 
WORD BDPKT 
.WORD CKRLK 


SET ACCESS/DEACCESS 
PENDING INTERLOCK 


SECOND LUN WORD. 
REMOVE FUNCTION 
CODE FROM STACK. 
RETRIEVE UCB ADDRESS. 
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FCDSP: 
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I/O PROCESSING 


REFERENCES: 


FCDSP: 


ee ee ee om 21 — READ VIRTUAL BLOCK 
CKNLN 32 — RECEIVE PROCESS IMAGE 
PART 17 
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PART 17 
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I/O PROCESSING 


REFERENCES: 


ee we re me 22 — WRITE VIRTUAL BLOCK 


CKNLN 31 — TRANSMIT PROCESS IMAGE 


PART 17 
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I/O PROCESSING 
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REFERENCES: 
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CHAPTER 7 
MODULE DESCRIPTIONS 


This chapter describes the modules, as individual units, that perform 
the RSX-11M Executive programming functions. 


The modules are described in alphabetical order and the description of 
a. new module always begins on a new page. 


7.1 CHAPTER ORGANIZATION 
The following information is presented in this chapter: 
@ Module name 
® Macro Library Calls 
e Entry points (routines) 
@e Function of this module or routines 
e Modules this module calls 
@e Entry (input) conditions 
e Exit (output) conditions 
The modules appear alphabetically and are grouped by system component. 


Thus, this chapter describes the Executive modules, then the FCP 
modules, and finally, the MCR modules; all alphabetically. 


7.1.1 Module Name 


The module name starts the description of each module. The name 
always appears at the top of a new page following the description of 
the previous module. A brief statement of the function of the module 
is included here. 


7.1.2 Macro Library Calls 


These calls appear in the code listing after the copyright notice. 
They are included here to show the data areas or control blocks to 
which the module refers. 


MODULE DESCRIPTIONS 


7.1.3 Entry Points 


The entry point is the global label in the module to which program 
control is transfered by another part of the program. It can also be 
considered as the label of a routine within the module. Statements 
about the function of the routine are included here. 


7.1.4 Calls 


Included here are all the calls (using the CALL or CALLR macro) that 
this routine executes. They are listed in order of appearance in the 
code. However, they may appear more than once in the code. 


7.1.5 Entry (input) Conditions 


Entry conditions are those conditions set up by the routine that 
called this routine or are present when this routine’ starts 
processing. These parameters or conditions are in data areas or 
registers in the form of data or addresses. The contents of these 
registers or data areas may be altered by this routine. 


7.1.6 Exit (output) Conditions 


Exit conditions may be changed register contents, data area contents, 
Stack contents, or status indicators. Usually, the output is needed 
by some other part of the system program. However, the routine or 
module may perform a function without producing anything that can be 
defined easily as “output”. In many of these cases, the routine 
indicates that it completed its operation by altering the C-bit or 
returning a directive status (for directive processing routines). 


7.2 EXECUTIVE MODULE DESCRIPTIONS 


7.2.1 BFCTL Module 


BFCTL The BFCTL module puts a byte or word into the user's 
buffer or gets a byte or a word out of the user's buffer. 
Also, moves data one byte at a time from place to place in 
the memory of a mapped system. 


Macro Library Calls 
HWDDFS Define hardware registers 


Entry Point - 

SGTBYT:: The GTBYT routine maps to the user buffer if Memory 
Management is defined. GTBYT gets the next byte from the 
user buffer and returns it to the caller on the stack. 
After the byte has’ been fetched, SGTBYT increments the 
next byte address. 


Calls None 


Input 
Output 

Note 

Entry Point 


SPTBYT:: 


Calls 


Input 


Output 
Note 


Entry Point 
SGTWRD:: 


Calls 
Input 


Output 


Note 


Entry Point 
SPTWRD:: 


Calls 


Input 


Output 


Note 
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R5 = Address of the UCB that contains the buffer pointers. 
The stack contains the byte from the user buffer. 
All registers are preserved across the call. 


The PTBYT routine maps to the user buffer if Memory 
Management is defined. PTBYT puts a byte in the next 
location in the user buffer and increments the next byte 
address. 

None 

R5 = Address of the UCB that contains the buffer pointers. 


Stack = Byte to be stored in the next location in the user 
buffer 


SPTBYT removes the byte from the stack and stores it in 
the user buffer. SPTBYT increments the next byte address. 


All registers are preserved across the call. 


Gets the next word from the user buffer and returns it to 
the caller on the stack. After the word has been fetched, 
SGTWRD calculates the next word address. 

None 

R5 = Address of the UCB that contains the buffer pointers. 


SGTWRD fetches the next word from the user buffer and 
returns it to the caller on the stack. 


Stack = Next word of user buffer 
All registers are preserved across the call. 


The PTWRD routine puts a word in the next location in the 
user buffer. After storing the word, SPTWRD calculates 
the next word address. 

None 


R5 = the address of the UCB that contains the buffer 
pointers. 


Stack = Word to be stored in the next location of the 
buffer. 


SPTWRD removes the word from the stack and stores it in 
the user buffer. 


All registers are preserved across the call. 


Entry Point 
SGTCWD:: 


Calls 
Input 
Output 


Note 


Entry Point 
SBLXIO:: 


Calls 


Input 


Output 


MODULE DESCRIPTIONS 


The GTCWD routine gets the next word from the user control 
buffer and returns it to the caller on the stack. 


None 

RS = Address of the UCB that contains the buffer pointers. 
SGTCWD fetches the next word from the user control buffer 
and returns it to the caller on the stack. 

Stack = next word of user buffer 


All: registers are preserved across the call. 


. The BLXIO routine moves data within the memory of a mapped 


system. 

None 

RO = Number of bytes to move 
Rl = Source APR5 bias 

R2 = Source displacement 

R3 = Destination APR6 bias 

R4 = Destination displacement 


After BLXIO finishes moving the data: 

RO and R5 are altered 

Rl and R3 are preserved 

R2 points to the last byte of the source +1 

R4 points to the last byte of the destination +l 


7.2.2 CORAL Module 


CORAL 


This module contains the core allocation routines. The 
memory search algorithm looks for the first block of 
memory that is available for allocation. The size is 
rounded upward to a multiple of four bytes. 


Macro Library Calls 


CLKDFS 
PKTDFS 


Entry Point 
SALOCB:: 
SALOC1:: 


Calls 


Input 


Output 


Define clock gueue control block offsets 
Define I/O packet offsets 


The ALOCB routine allocates a core buffer 
The ALOC1] routine allocates a core buffer (alternate 
entry) 


None 


RO = Address of core allocation listhead -2 if entry is at 
$ALOC1. 


R1 Size of the core buffer to allocate in bytes 


C = 1 if insufficient core is available to allocate the 
block 

C = 0 if the biock is allocated 

RO = Address of the allocated block 

R1 = Length of the allocated block 


Entry Point 
SALCLK:: 


Calls 
Input 
Output 


Note 


Entry Point 
SALPKT:: 


Calls 
Input 


Output 


Entry Point 
$DEACB:: 
SDEACI1:: 


Calls 


Input 


Output 


Error 


Entry Point 


SDECLK:: 


Calls 
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The ALCLK routine allocates a core block for a clock queue 
entry. This routine stores the length of the clock block 
in Rl. 


None 
None 


If core is not available to allocate the block, SALCLK 
returns a ‘'D.RS1' directive status. If enough core is 
available, SALCLK returns the address of the allocated 
block to the caller in RO. 


The ALCLK routine shares common code with the ALPKT 
routine. 


The ALPKT routine allocates a core block for a SEND or I/0 
REQUEST gueue entry. SALPKT stores the length of the 1/0 
Packet (I.LGTH) in Rl and calls SALOCB to allocate the 
block. 


SALOCB 
None 


If core is not available to allocate the block, S$ALPKT 
returns a directive status of 'D.RS1'. Otherwise, SALKPT 
returns the address of the allocated block to the caller 
in RO. 


The DEACB routine deallocates the core buffer. 
The DEAC] routine deallocates the core buffer (alternate 
entry). 


DEAC inserts the Executive core block to be deallocated 
into the free block chain by core address. If an adjacent 
block is currently free, DEAC merges the two blocks”) and 
inserts them in the free block chain. 


None 


RO = Address of the core buffer to be deallocated 

Rl = Size of the core buffer to deallocate in bytes 

R3 = Address of core allocation listhead -2 if entry is at 
$DEAC1 


DEAC merges the core block into the free block chain by 
core address and agglomerates it with adjacent free 
blocks. 


The system crashes if deallocation is attempted before the 
front or past the end of the system pool. 


The DECLK routine deallocates a core block that was used 
for a clock queue entry. 


None (branches to $DEACB) 


Input 


Output 


Entry Point 
SDEPKT: : 
Calls 

Input 
Output 


Note 


MCDULE DESCRIPTIONS 


RO = Address of the core block to be deallocated 


DECLK deallocates the clock gueuve entry core block and 
agglomerates adjacent free core blocks. 


The DEPKT routine deallocates a core block that was used 
for a SEND or I/O REQUEST queue entry. 


None 
RO = Address of the core block to be deallocated. 
The core block is deallocated. 


This routine uses the code in the DEACB routine. 


7.2.3 CRASH Module 


CRASH 


This module is entered via a JUMP whenever a fatal system 
error is detected. This routine dumps memory on a 
DECtape, RKO5, TU10 or TU16. The first block of the dump 
contains information about the state of the system at the 
time of the crash. When the dump is finished, you may 
reboot the system or re-execute the dump. 


This module uses the following local data and routines: 


CRSMSG: er a /CRASH -- CONT WITH SCRATCH MEDIA ON 
xx0 
wheres xx = DT, DK, MT, or MM 

SCRSBF:: Internal crash stack 

SCRSST#= Top of crash stack 

SCRSBN:: Starting device address 

SCRSCS:: Checksum of device address 

AGAIN: Type a message and wait for the user 

SCRSHT:: Wait for the user 

SCRSUN:: Crash unit number 


TYPE: Type an ASCIZ message 
CKSUM: Verify checksum of device address 
DUMP: Dump the system image 


Macro Library Calls - 


HWDDFS 


Define hardware registers 


Entry Point - 


SCRASH:: 
Calls 


Input 


Output 


This is the system crash dump routine. 
TYPE, CKSUM 


02(SP) = PS word at crash. 
(SP) = PC word at crash. 


The internal crash stack and a core image of the system 
(up to 128K) are dumped onto the crash dump device. 
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7.2.4 CVRTM Module 


CVRTM 


The CVRTM routine converts a pair of time interval-time 


units to a clock ticks count. 


Macro Library Calls - 


None 


Entry Point - 


SCVRTM: : 


Calls 
Input 


Output 


7.2.5 


DRABO 


Time interval-units pair to clock ticks count conversion 
$MUL 
R3 = Address of the time interval pair. 


CVRTM returns the ticks count to the 
placing the high order part in RO and the low order part 
in Rl. CVRTIM advances R3 by 4, thus pointing past the 
time interval-time units pair. If the calling routine 
specified an illegal time interval (greater than 15 bits) 
or illegal time units (0 or greater than 4), CVRTM returns 
a directive status of 'D.RS93'. 


calling routine by 


DRABO Module 


The directive processing module, DRABO, terminates 


(aborts) the execution of a specified task. 


Macro Library Calls - 


ABODF$ 


Define task abort codes. 


Entry Point - 


SDRABOs: : 
Calls 


Input 


Output 


Note 


Error 


The DRABO routine aborts a specified task. 
SABTSK 


RO = Address of the TCB of the task to be terminated. 


Rl = Address of the task status word of the task to be 
ended. 

R2 = Address of the task status word of the current task. 

R3 = Address of the last word in the DPBt2. 

R4 = Address of the header of the current task. 

R5 = Address of the TCB of the current task. 


DRABO returns directive status (D.RS7) and PS to the task. 


C = 0 if DRABO successfully completed execution. 
DRABO returns a directive status of +l. 


Also, 


C = 1 if DRABO is rejected. 


Directive status returned: 
'D.RS7' if the specified task is not active 


DPB format: 


WD. 00 -- DIC(83.),DPB size(3.) 
WD. Ol1 -- First half of task name 
WD. 02 -- Second half of task name 


Reason for abort (in S.CABO) is set into RO before calling 
SABTSK. 


MODULE DESCRIPTIONS 


7.2.6 DRASG Module 


DRASG 


The directive processing module, DRASG, assigns a device 
unit to a logical unit number. 


Macro Library Calls - 


TCBDFS 
Entry Point 
SDRASG:: 
Calls 


Input 


Output 


Note 


Define task control block offsets. 


Assigns logical unit number (LUN) 
SMPLUN, S$MPLND, $MUL 


R2 = Address of the task status word of the current task. 
R3 = Address of the logical unit number in the DPB. 

R4 = Address of the header of the current task. 

R5 = Address of the TCB of the current task. 


DRASG returns directive status and PS to the calling 
routine. 


C = 0 if DRASG successfully completes execution. Also, 
DRASG returns a directive status of +l. 


C = 1 if the DRASG directive routine is rejected. 


Directive status returned: 

'p.RS90' if a file is open or a unit is attached on the 
specified LUN. 

'p.RS92' if a device or unit, or device and unit are 
invalid. 


The DPB format is: 

WD. 00 -- DIC(7.),DPB size(4.) 

WD. O1 -- LUN to be assigned 

WD. 02 -- Name of device to be assigned 

WD. 03 -~ Unit number of device to be assigned 


7.2.7 DRATX Module 


DRATX 


The directive processing module DRATX instructs the system 
to end the execution of an asynchronous system trap (AST) 
service routine. If another AST is queued and AST's are 
not disabled, the next gueued AST is immediately executed. 


Macro Library Calls - 


ABODFS 
HDRDFS 
HWDDFS 


Conditional 
ASSTRP 
CSSCKP 
DSSISK 
MSSMGE 
ASS$CHK 


Define task abort codes 
Define task header offsets 
Define hardware registers 


Assembly Parameters - 

AST support 

Checkpointing support 
Non-resident task support 
Memory management 

Address checking 


Entry Point 
SDRATX:: 


Calls 


Input 


Output 


Note 


Error 


MODULE DESCRIPTIONS 


The DRATX routine ends AST service. 
SNXTSK, SACHCK, $RELOM, SSETRT, SABCTK 


R2 = Address of the task status word of the current task 
R3 = Address of the last word in the DPB +2 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRATX returns a directive status and PS word to the task. 


c= 0 if the DRATX routine successfully completed 
execution. Also, the DRATX routine restores the 
status of the pre-AST state. 


C = 1 if the DRATX routine is rejected. 


Directive status returned: 
'p.RS80' if an AST service routine did not execute the 
DRATX directive. 


If an address check failure occurs while removing 
arguments from the task stack, the issuing task is aborted 
(S.CAST is placed in RO and S$ABCTK is called). 


The DPB format is: 
WD. 00 —- DIC(115.),DPB size(l.) 


At issuance, the task stack contains: 
14(SP) = (Unused) 


12(SP) = (Unused) 

10(SP) = (Unused) 

06(SP) = Event flag mask word. 

04(SP) = Pre-AST task PS 

02(SP) = Pre-AST task PC 

0O(SP) = Pre-AST task directive status word 


Possible ABORT as described in above note. 


7.2.8 DRCIN Module 


DRCIN 


The DRCIN module either connects or disconnects a 
specified interrupt vector to an interrupt service routine 
(ISR) in the task's own space. 


Macro Library Calls - 


HWDDFS$ 
TCBDFS$ 
PCBDF$ 
ITBDFS$ 


Entry Point 
SDRCIN:: 


Define hardware registers 

Define task control block offsets 

Define partition control block offsets 

Define interrupt transfer block (ITB) offsets 


This routine connects a specified interrupt vector to an 
interrupt service routine (ISR) in the task's own space. 
DRCIN allocates a block of dynamic memory and sets up the 
block as an interrupt transfer block (ITB). The ITB is 
linked to the ITB list of the task with the Jlisthead, a 
single word, in T.CPCB of the MTCB. DRCIN disables 
shuffling and checkpointing for the task and sets up the 
vector to point to the offset X.JSR in the ITB that 
contains a subroutine call to the special interrupt save 
routine SINTSC. 


Input 


Output 


Note 


Entry Point 
S$DISIN:: 


MODULE DESCRIPTIONS 


R2 = Address of the task status word of the current task 
R3 = Pointer to WD. 01 in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRCIN returns directive status and the PS to the task. 


C = 0 if DRCIN successfully completes execution with a 
directive status of +l. 


C = 1 if execution is unsuccessful. 


Directive status returned: 

D.RSI1 An ITB could not be allocated (no pool space) 

D.RS8 The function requested is disconnect and the task 
is not the owner of the vector. 

D.RS16 Issuing task is not privileged 

D.RS17 The specified vector is already in use 

D.RS19 The specified vector is illegal (lower than 60 or 
higher than the highest vector specified at 
SYSGEN, or not a multiple of 4) 

D.RS81 The ISR or disable-interrupt routine is not within 
4K words from the specified base address © 


The DPB format is: 
WD. 00 -=— DIC(129.), DPB size(7.) 


WD. O01 -- Interrupt vector address 
WD. 02 -- Base address for mapping of ISR and 
disable-interrupt routines. Ignored in an 


unmapped system. 

WD. 03 -- Address of interrupt service routine. If zero, 
directive is "disconnect from interrupts" and 
remaining arguments are ignored. 

WD. 04 -- Address of disable interrupt routine 

WD. 05 -- (Low byte) low byte of PSW to be set before 
calling ISR 

WD. 06 -- Address of AST routine 


This routine disconnects a specified interrupt vector from 
an interrupt service routine (ISR) in the task's own space 
and deallocates the associated block of memory. 


When disconnecting the last or only vector, DISIN clears 
the checkpoint-disable bit (T2.CKD) and the no-shuffle bit 
(PS.NSF). DISIN does this regardless of what the state 
was before vectors were connected or any change in state 
while vectors were connected except if the task is marked 
for abort. In this case it is not made shufflable. 


The routine DISIN: 


l. Removes the ITB from the ITB list starting in T.CPCB 
of the task's TCB 

2. Calls the user routine that disables interrupts and 
that was supplied to DRCIN and to which the vector 
was connected. 

3. Restores the vector PC to point to the nonsense 
interrupt routine 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


4. Removes the fork block of the ITB if it is in the 
fork queue 

5. Removes the AST block of the ITB if it is in the AST 
gueue for the task 

6. Enables checkpointing for the task if this was the 
only vector connected to the task and makes the task 
shufflable if the task runs in a system controlled 
partition. 

7. Deallocates the ITB 


Rl = Pointer to the interrupt transfer block (ITB) 
R5 = Pointer to task TCB 


C = 0 if DISIN successfully completes execution 
C = 1 if the task is not the owner of the vector 


Registers RO, Rl, R2, and R3 are altered by this routine 


7.2.9 DRCMT Module 


DRCMT 


DRCMT contains the following directive processing 
routines: 


SDRCMT Cancel:all mark time requests for the issuing 
task 

SDRCSR Cancel all schedule requests for a specified 
task 


Macro Library Calls - 


CLKDF$ 


Entry Point 
SDRCMT:: 


Calls 


Input 


Output 


Note 


Entry Point 
SDRCSR:: 


Calls 


Define clock queue control block offsets 


The DRCMT routine cancels all mark time requests for the 
issuing task. 


None 

R2 = Address of the task Status word of the current task 
R3 = Address of the last word in the DPB +2 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 

DRCMT returns directive status and the PS to the task. 

C = 0 with a directive status of +1 

This routine is also called from the EXIT directive and 
requires only R5 to be loaded on entrance. 

DRCMT shares common code with DRCSR. 


The DPB format is: 
WD. 00 -— DIC(27.),DPB size(l.) 


The DRCSR routine cancels all schedule reguests for a 
specified task. 


SCLRMV - to remove periodic single-shot reguests, 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


RO = Address of the TCB for which to cancel. schedule 
requests 

Rl = Address of the task status word of the task for which 
to cancel schedule requests 

R2 = Address of the task status word of the current task 

R3 = Address of the last word in the DPB +2 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRCSR returns directive status and PS to the task. 
C = 0 with a directive status of +l 


The DPB format is: 

WD. 00 -= DIC(25.),DPB size (3.) 
WD. O01 -- First half of task name 
WD. 02 -— Second half of task name 


7.2.10 DRDAR Module 


DRDAR 


The directive processing module, DRDAR, disables 
recognition of asynchronous system traps for the issuing 
task. 


DRDAR contains the following directive processing 
routines: 

SDRDAR Disable AST recognition 

SDREAR Enable AST recognition 


Macro Library Calls - 


TCBDFS 


Define task control block offsets 


Entry Point - 


SDRDAR:: 
Calls 


Input 


Output 


Note 


Entry Point 
SDREAR:: 


The DRDAR routine disables AST recognition. 


= Address of the task status word of the current task 
= Address of the last word in the DPB +2 

R4 = Address of the header of the current task 
= Address of the TCB of the current task 


DRDAR returns directive status and PS to the calling task. 


C = 0 if the DRDAR directive successfully completes. 
Also, DRDAR returns a directive status of +l. 


C = 1 if the DRDAR routine is rejected. 


Directive status returned: 
'D.RS8' if AST recognition is already disabled. 


The DPB format is: 
WD. 00 -- DIC(99.),DPB size(l.) 


The DREAR routine causes’ the system to recognize 
asynchronous system traps for the issuing task. ASTs that 
have been gueued while AST recognition was disabled are 
processed immediately. 


Calls 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


SSETRT 


R2 
R3 
R4 
R5 


Address of the task status word of the current task 
Address of the last word in the DPB +2 

Address of the header of the current task 

Address of the TCB of the current task 


DREAR returns directive status and PS to the task. 


C = 0 if the DREAR routine successfully completes. Also, 
DREAR returns a directive status of +l. 


C = 1 if the DREAR routine is rejected. 


Directive status returned: 
'pD.RS8' if AST recognition is not disabled. 


The DPB format is: 
WD. 00 -= DIC(101.),DPB size (1.) 


7.2.11 DRDCP Module 


DRDCP 


The directive processing module, DRDCP, causes the system 
to disable or enable checkpointing of the issuing task. 


DRDCP contains the following directive processing 
routines: 

$DRDCP Disable checkpointing 

SDRECP Enable checkpointing 


Macro Library Calls - 


TCBDF$ 


Define task control block offsets 


Entry Point - 


SDRDCP:: 
Calls 


Input 


Output 


Note 


Disable checkpointing 
None 


R2 
R3 
R4 
R5 


Address of the task status word of the current task 
Address of the last word in the DPB +2 

Address of the header of the current task 

Address of the TCB of the current task 


DRDCP returns directive status and PS to the task. 


c = 0 if the DRDCP routine successfully completes 
execution. Also, DRDCP returns a directive status 
of +l. 


Cc = 1 if the DRDCP routine is rejected. 


Directive status returned: 

'D.RS8' if checkpointing is already disabled for the 
issuing task. 

'D.RS10' if the issuing task is not checkpointable. 


The DPB format is: 


Entry Point 
SDRECP:: 


Calls 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


The DRECP routine enables checkpointing of the issuing 
task. 


SNXTXK 


R2 
R3 
R4 
R5 


Address of the task status word of the current task 
Address of the last word in the DPB +2 

Address of the header of the current task 

Address of the TCB of the current task 


DRECP returns directive status and PS to the task. 

c= 0 if the DRECP routine successfully completed 
execution. Also, DRECP returns a directive status 
of +l. 

C = 1 if the DRECP routine is rejected. 


Directive status returned: 
'D.RS8' if checkpointing is already enabled. 


The DPB format is: 
WD. 00 -— DIC(97.),DPB size(l.) 


7.2.12 DRDSP Module 


DRDSP 


The DRDSP module is the directive dispatcher. 


DRDSP contains the following directive processing 
routines: 

$TRTRP The TRAP instruction traps to this routine 
SEMTRP The EMT instruction traps to this routine 


Macro Library Calls - 


HDRDFS 
HWDDFS 
TCBDFS$ 
WDBDFS$ 


Entry Point 


STRTRP:: 


Calls 


Input 


Output 


Define task header offsets 

Define hardware registers 

Define task control block offsets 

Define user window definition block offsets 


During execution, a TRAP instruction traps to this 
routine. TRTRP returns a directive status if the stack 
depth is zero. Otherwise, TRTRP transfers control to’ the 
EMT/TRAP synchronous system trap handling routine. 


None 


2(SP) = PS word pushed by TRAP instruction 
(SP) = PC word pushed by TRAP instruction 


TRTRP returns directive status in the stack if stack depth 
is zero. 


MODOLE DESCRIPTIONS 


Entry Point - 


SEMTRP:: 


Calls 


Input 


Output 


Note 


7.2.13 


DREIF 


When an EMT instruction execution occurs, the trap occurs 
to this routine. EMTRP crashes the system if the stack 
depth is not +l. If the stack depth is +1, EMTRP checks 
the EMT instruction for the presence of code 377. If the 
code was other than 377, EMTRP transfers control to the 
EMT/TRAP SST handling routine. If 377 was present, EMTRP 
processes the coded directive. 


The following processing occurs within EMTRP. 
The EMTRP routine: 


1. Calls S$DIRSV (coroutine) to switch to system state and 
save registers RO — R5. 


2. Checks directive validity (DIC odd, size of DPB 
valid). 

3. Maps to DPB using KAPR6 if a mapped system is being 
used. 

4. Processes common functions if required (for instance, 
masks). 


5. Sets up the following registers prior to calling the 
directive processing routine: 
RS = Address of current task's TCB 
R4 = Address of current task's header 

R3 = Address of the next word in the directive DPB 

R2 = Address of second task status word of the current 

task 

Rl = Directive dependent 
RO = Directive dependent 

6. Calls the Directive Processing routine 

7. Sets the DSW, gets correct stack pointers, and 
restores registers. 

8. Enters $DIRXT through SDIRSV which restores RO - R5 
and exits. 


SACHK2, SACHKP, SCEFN, $SRSTD, $DIRSV, SSWSTK, SEMSST 


2(SP) = PS word pushed by the EMT instruction 
(SP) = PC word pushed by the EMT instruction 


EMTRP crashes the system if the stack depth is not +l. 
Otherwise, EMTRP gives control to the EMT/TRAP SST routine 
or the specified directive routine. If the EMT had a code 
of 377, EMTRP gives control to the specified directive 
routine. 


The stack depth (S$STKDP) is defined in SYSCM. 


DREIF Module 


This is the EXIT directive processing module. 


DREIF contains the following directive processing 
routines: 


SDREIF End execution of issuing task if specified event 
flag is clear 
SDREXT End execution of issuing task 


MODULE DESCRIPTIONS 


Macro Library Calls - 


ABODFS 
HDRDFS$ 
PCBDFS 
PKTDFS 
TCBCFS 


Entry Point 
SDREIF:: 


Calls 


Input 


Output 


Note 


Entry Point 
DREXT: : 


Calls 


Input 


Output 


Note 


Define task abort codes 

Define task header offsets 

Define partition control block offsets 
Define I/O packet offsets 

Define task control block offsets 


This routine causes the system to end the execution of the 
issuing task only if an indicated event flag is clear. 


None 


RO = Event flag mask word 
= Event flag mask address 

= Address of the task status word of the current task 
R3 = Address of the last word in the DPBt+2 

= Address of the header of the current task 

= Address of the TCB of the current task 


DREIF returns directive status and the PS to the task. 
C = 0 if DREIF successfully completes processing. 
C = 1 if DREIF is rejected. 


Directive status returned: 

'D.RS22' if the specified event flag is set. 

'p.RS97' if an invalid or no event flag number was 
specified when DREIF was called. 

The DPB format is: 

WD. 00 -— DIC(53.),DPB size(2.) 

WD. 01 -- Event flag number of event flag that must be 
clear 


The DREXT routine causes the system to end the execution 
of the issuing task. 


SDRCMT, S$DRSIN, $RLMCB, $DASTT, S$ABCTK, $IOKIL, S$ALOCB, 
SDRQRQ, SACTRM, SEXRON, S$TKWSE, S$CSTA, $QMCRL, SRLPAR, 
$DETRG, $DEACB, $DRDSE, $QRMVF, $FINBF, $MPLNE, 


R2 = Address of the task status word of the current task 
R3 = Address of the last word in the DPB +2 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


The dispatcher also calls this routine. When this occurs, 
only R5 need be loaded on entrance. 


The DREXT routine returns directive status and the PS _ to 
the task. 


No other status is returned to the task because this 
routine ends the task's execution. 


The DPB format is: 
WD. 00 == DIC(51.),DPB size(l.) 


The DREXT routine contains a subroutine to empty a queue 
(MTQUE:) and a coroutine to scan a logical unit table 
(SCNLN:). 


MODULE DESCRIPTIONS 


7.2.14 DREXP Module 


DREXP 


The DREXP module extends the partition by a positive or 
negative increment. 


Macro Library Calls - 


HWDDFS$ 
HDRDF$ 
PCBDF$ 
TCBDF$ 


Entry Point 
SDREXP:: 
Calls 


Input 


Output 


Note 


Define hardware offsets 

Define task header offsets 

Define partition control block offsets 
Define task control block offsets 


The DREXP routine causes the system to extend the 
partition of the issuing task by a positive or negative 
amount. | 


SSETRT, SCHKPT, SMAPTK 


R2 = Address of the second task status word of the current 
task 

R3 = Address of the extend increment in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


The DREXP routine returns directive status and the PS to 
the task. 


C = 0 if the DREXP routine successfully completes 
processing. Also, DREXP returns a directive status 
of +1. 


C=l1if the DREXP routine is rejected. 


Directive status returned: 
'D.RS8' under the following conditions: 


e The task is not checkpointable and specified a positive 
increment 

e The task has a preallocated checkpoint space and is 
trying to extend its space greater than the installed 
size. 

e The task is not in a system controlled partition. 


'D.RS88' if the specified increment is invalid. 


The DPB format is: 

WD. 00 -= DIC(89.),DPB size(3.) 
WD. O01 -=— Extend increment 

WD. 02 -- Reserved 


MODULE DESCRIPTIONS 


7.2.15 DRGCL Module 


DRGCL 


Entry Point 
SDRGCL:: 


Calls 


Input 


Output 


Note 


Entry Point 
SRLMCB:: 


Calls 


Input 


Output 


The directive processing module, DRGCL, gets the MCR 
command line or releases the MCR command buffer. 


DRGCL contains the following directive processing 

routines: 

SDRGCL Transfer a1 through 80 byte command line to MCR 
‘function task 

$RLMCB Release MCR .command buffer 


The DRGCL routine causes the system to transfer a 1 
through 80. byte command line to the last MCR function 
task requested by the dispatcher. 


Calls a subroutine to search for the command buffer for 
the current task. 


R2 = Address of' the task status word of the current task 
R3 = Address off the 80. byte buffer in the DPB. 

R4 = Address off the header of the current task 
R5 = Address of the TCB of the current task 


DRGCL returns the directive status and the PS to the 
current task. 


C = 0 if DRGCL successfully completed execution. Also, 
DRGCL returns a directive status egual to the length 
of the command line in bytes. 


C = 1 if DRGCL does not complete execution. 


Directive status returned: 
'D.RS80' if the issuing task is not the last task that was 
requested by the MCR dispatcher. 


The DPB format is: 

WD. 00 -- DIC(127.),DPB size(41.) 

WD. O1 through WD. 50 -- First through last word of the 
80. byte buffer 


The RLMCB routine releases the MCR command buffer. 


SDEACB, 30$ (Subroutine to search for the command buffer 
for the current task) 


R5 = Address of the TCB of the current task 
If the command line currently in the MCR command buffer is 


for the current task, RLMCB releases the buffer and clears 
SMCRIN. 


MODULE DESCRIPTIONS 


7.2.16 DRGLI Module 


DRGLI The directive processing module, DRGLI, causes the system 
to £111 a six word buffer with information about a device 
that is assigned to a specified LUN. If requests to _ the 
device have been redirected, the information returned by 
DRGLI pertains to the redirected device. 


Macro Library Calls - 
HWDDFS$ Define hardware registers 


Entry Point - 


SDRGLI:: Puts logical unit number information into a six word 
buffer. 

Calls SMPLUN, SACHKP, $DIV 

Input R2 = Address of the task status word of the current task 


R3 = Address of the LUN in the DPB 
R4 = Address of the header of the current task 
R5 = Address of the TCB of the current task 


Output The DRGLI routine returns directive status and the PS _ to 
the task. 
C = 0 if DRGLI successfully completes. Also, DRGLI 


returns a directive status of +l. 


Cc 1 if DRGLI does not complete exection. 


Directive status returned: 
'pD.RS5S' if no device is assigned to the specified LUN. 


Note The DPB format is: 
WD. 00 -- DIC(5.),DPB size(3.) 
WD. 01 -- LUN for which information is returned 


WD. 02 -- Address of a six word buffer 
The six-word buffer format is: 
WD. 00 -- Name of assigned device 
WD. 01 -- Unit number of assigned device and flags byte 
WD. 02 -- First device characteristics word 
WD. 03 -- Second device characterisitics word 
WD. 04 -- Third device characteristics word 
WD. 05 -- Fourth device characteristics word 


7.2.17 DRGPP Module 


DRGPP The directive processing module, DRGPP, causes the system 
to fill a 3-word buffer with partition parameters. 


Macro Library Calls - 
PCBDFS Define partition control block offsets 
TCBDFS Define task control block offsets 


Entry Point - 
SDRGPP:: The directive processing routine, DRGPP, fills a 3-word 
buffer with partition parameters. 


MODULE DESCRIPTIONS 


Calls SSRATT, SSRNAM, SACHKP 

Input R2 = Address of the task status word of the current task 
R3 = Address of the partition name in the DPB 
R4 = Address of the header of the current task 
RS = Address of the TCB of the current task 

Output The DRGPP routine returns directive status and the PS _ to 
the task. © 


C = 0 if DRGPP successfully completed execution. Also, 
DRGPP returns a directive status equal to the 
starting virtual address of the specified partition. 


C = 1 if DRGPP is rejected. 


Directive status returned: 
'D.RS2' if the specified partition is not in the system. 


Note The DPB format is: 
WD. 00 -- DIC(65.),DPB size(4.) 
WD. O1 -- First half of optional partition name 
WD. 02 -- Second half of optional partition name 
WD. 03 -- Address of a three word buffer 


The buffer format is: 


WD. 00 -- Base address of the partition in 32 word blocks 
WD. O01 -- Size of the partition in 32 word blocks 
WD. 02 -- Partition flags word 


7.2.18 DRGSS Module 

DRGSS The directive processing module, DRGSS, causes the system 
to store the contents of the console switch register in 
the issuing task's directive status word. 

Macro Library Calls - 

HWDDFS Define hardware registers 


Entry Point - 


SDRGSS:: This routine gets the sense switch information. 

Calls None 

Input R2 = Address of the task status word of the current task 
R3 = Address of the last word in the DPB +2 
R4 = Address of the header of the current task 
R5 = Address of the TCB of the current task 

Output The DRGSS routine returns the directive status and the PS 


to the task. 


C = 0 with a directive status equal to the contents of the 
console switch register. 


Note The DPB format is: 
WD. 00 -=— DIC(125.),DPB size(l.) 


MODULE DESCRIPTIONS 


7.2.19 DRGTK Module 


DRGTK 


The directive processing module, DRGTK, causes the system 
to fill a 16-word buffer with task parameters. 


Macro Library Calls - 


HDRDFS$ 
PCBDFS 
TCBDFS 


Entry Point 
SDRGTK:: 
Calls 


Input 


Output 


Note 


Define task header offsets 
Define partition control block offsets 
Define task control block offsets 


This routine gets task parameters. 
None 


R2 = Address of the task status word of the current task 
R3 = Address of the sixteen word buffer in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRGTK returns directive status and the PS to the task. 
C = 0 with a directive status of +l. 


The DPB format is: 
WD. 00 ~- DIC(63.),DPB size(2.) 
WD. 01 -- Address of a sixteen word buffer 


The buffer format is: 

WD. 00 -- First half of the name of the issuing task 

WD. 01 -- Second half of the name of the issuing task 

WD. 02 -- First half of the name of the task's partition 
WD. 03 -- Second half of the name of the task's partition 
WD. 04 -— First half of requesting task's name (not 


supported) 
WD. 05 -- Second half of reguesting task's name (not 
supported) 
WD. 06 -- Task priority 
WD. O07 -=— Current task JIC 
WD. 10 -- Number of logical units 
WD. 1l -- Machine type indicator (not supported) 
WD. 12 -- Standard flags word (not supported) 
WD. 13 -- Address of task SST vector table 
WD. 14 -- Size of task SST vector table in words 
WD. 15 -= Size of task in bytes 
WD. 16 -- Reserved 
WD. 17 -- Reserved 


7.2.20 DRGTP Module 


DRGTP 


Entry Point 
SDRGTP:: 


The directive processing module, DRGTP, causes the system 
to fill a specified 8-word buffer with the current time 
parameters. 


The DRGTP routine fills an 8-word buffer with the current 
time parameters. 


Macro Library Calls - 


None 


MODULE DESCRIPTIONS 


Calls SACHKP 

Input R2 = Address of the task status word of the current task 
R3 = Address of the second word in the DPB 
R4 = Address of the header of the current task 
R5 = Address of the TCB of the current task 

Output The DRGTP routine returns directive status and the PS _ to 
the task. — 


C= 0 if the DRGTP routine successfully completes 
execution, Also, DRGTP returns a directive status 
of +1. 


C = 1 if DRGTP does not complete execution. 
Directive status returned: 
'p.RS98' if the buffer is outside the issuing task's 
address space. 
Note The DPB format is: 
WD. 00 -- DIC(61.),DPB size(2.) 
WD. 01 -= Address of an eight word buffer 


The buffer format is: 


WD. 00 -~ Year since 1900 
WD. O01 -- Month of year 
WD. 02 -=- Day of month 


WD. 03 -- Hour of day 

WD. 04 -- Minute of hour 
WD. 05 -- Second of minute 
WD. 06 -- Tick of second 


7.2.21 DRMAP Module 


DRMAP The directive processing module, DRMAP, contains the 
following routines: 
SDRCRW: : Create an address window 
SDRELW: : Eliminate address window 
SDRMAP:: Map window to region 
SDRUNM: : Unmap address window 
SDRSRF:: Send by reference 
SDRRRF:: Receive by reference 


These directive processing routines receive, as input, 
pointers to a window definition block. The window 
definition block serves as a communication area between 
the issuing task and the Executive. 


MODULE DESCRIPTIONS 


The format of the window definition block is: 


W.NAPR 

W.NID BASE APR WINDOW ID 
W.NBAS , VIRTUAL BASE ADDRESS (BYTES) 
W.NSIZ WINDOW SIZE (32W BLOCKS) 

W.NRID REGION ID 

W.NOFF OFFSET IN PARTITION (32W BLOCKS) 
W.NLEN LENGTH TO MAP (32W BLOCKS) 
W.NSTS STATUS WORD 

W.NSRB SEND/RECEIVE BUFFER ADDRESS (BYTES) 


Macro Library Calls - 


HDRDFS 
PCBDFS$ 
TCBDFS 
WDBDFS$ 


Entry Point 
$DRCRW: : 


Calls 


Define header and window block offset 

Define PCB and attachment descriptor offsets 
Define TCB offsets 

Define window definition block offsets 


The DRCRW routine causes the system to allocate an address 
window in the header of the issuing task. The routine 
unmaps and eliminates overlapping address windows and, 
optionally, maps the new window. 


ELAW (to eliminate address window) 


Input 


Output 


Note 


Entry Point 
SDRELW: : 


Calls 


MODULE DESCRIPTIONS 


R2 = Address of the task status word of the current task 
R3 = Address of the window definition block 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Input fields of the window definition block are: 


W.NAPR = Base APR of region 
W.NSIZ = Desired size of address window 
W.NRID = ID of region to map or zero (0) for task region 
(if WS.MAP = 1) 
W.NOFF = Offset within region to map (if WS.MAP = 1) 
W.NLEN = Contains either length to map or zero (0). If 
zero, W.NLEN defaults to the smaller of the 
following: window size or size left in partition 
(if WS.MAP = 1) 
W.NSTS = Control information 
WS.MAP = 1 if mapping is to occur 
WS.WRT = 1 if mapping is to occur with write access 


The DRCRW routine returns directive status and the PS _ to 
the task. 


C = 0 if DRCRW successfully completes execution. Also, 
DRCRW returns a directive status of +l. 


C = 1 if DRCRW does not complete execution. 


Directive status returned: 

'D.RS16' if the specified access is denied in the mapping 
stage of execution. 

'D.RS84' if an invalid APR and window size combination or 
an invalid region and offset-length combination 
was specified in the mapping stage of execution. 

'D.RS85' if no window blocks are available for use. 

'D.RS86' if an invalid region was specified in the mapping 
stage of execution. 


Output fields in the window definition block are: 

W.NID = Assigned window ID 

W.NBAS = Virtual base address of window 

W.NLEN = Length actually mapped 

W.NSTS = Indication of any changes in mapping status 
WS.CRW = 1 if address window is successfully established 


WS.ELW = 1 if any address windows were eliminated 
WS.UNM = 1 if any address windows were unmapped 
The DPB format is: 
WD. 00 -- DIC(117.),DPB size(2.) 
WD. O01 -- Address of window definition block 


The DRELW routine causes the system to eliminate the 
specified address window, unmapping it first if necessary. 


SSRWND, SUNMAP 
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Input 


Output 


Note 


Entry Point 
SDRMAP: : 


Calls 


Input 


MODULE DESCRIPTIONS 


R2 = Address of the task status word of the current task 
R3 = Address of the window definition block 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Input fields in the window definition block are: 
W.NID = ID of address window to eliminate 


The DRELW routine returns directive status and the PS to 
the task. 


C = 0 if DRELW successfully completed execution. Also, 
DRELW returns a directive status of +l to the task. 


C = 1 if DRELW is rejected. 


Directive status returned: 
'D.RS87' if an invalid address window was specified. 


Output fields in the window definition block are: 
W.NSTS = Indication of any changes in mapping status 
WS.ELW = 1 if DRELW successfully eliminated the address 
window 
WS.UNM = 1 if DRELW found the address window already 
unmapped 


The DPB format is: 
WD. 01 -- Address of window definition block 


The DRMAP directive processing routine causes the system 
to map the specified address window to an offset in the 
specified region. DRMAP unmaps the window if necessary. 
DRMAP first builds an image of a mapped window block on 
the stack. If DRMAP encounters no errors during this 
process, DRMAP unmaps the corresponding window, if 
necessary, and sets up the new window from the stack 
image. 


SSRWND, SSRATT, SUNMAP 


R2 = Address of the task status word of the current block 
R3 = Address of the window definition block 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Input fields in the window definition block are: 

W.NID = ID of window to be mapped 

W.NRID = ID of region to which to map. If W.NRID is 0, 
mapping occurs to the task region. 

W.NOFF = Offset within region to which to map 

W.NLEN = Length to map. If 0, W.NLEN defaults to window 
size or the size left in the partition. 

W.NSTS = Control information 

WS.WRT = 1 if write access is desired 


Output 


Note 
Entry Point 


SDRUNM 


Calls 


Input 


Output 


Note 


MODOLE DESCRIPTIONS 


The DRMAP routine returns directive status and the PS to 
the task. 


C = 0 if DRMAP successfully completes execution. Also, 
DRMAP returns a directive status of +l to the task. 


C = 1 if DRMAP is rejected. 


Directive status returned: 

'D.RS16' if the desired access to the region is denied. 

'D.RS84' if an invalid region and offset size combination 
is specified. 

'D.RS86' if an invalid region ID is specified. 

'D.RS87' if an invalid address window is specified. 


Output fields in the window definition block are: 

W.NLEN * Length actually mapped 

W.NSTS = Indication of any changes in mapping status. 
WS.UNM = 1 if the window was unmapped first 


The DPB format is: 
WD. 00 -—- DIC(121.),DPB size(2.) 
WD. O1 -— Address of window definition block 


The DRUNM routine causes the system to unmap the specified 
address window. 


SSRWND, SUNMAP 


R2 = Address of the task status word of the current task 
R3 = Address of the window definition block 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Input fields in the window definition block are: 
W.NID = ID of the window to be unmapped 
DRNUM returns directive status and the PS to the task. 


C = 0 if DRUNM successfully completes’ execution. Also, 
DRUNM returns a directive status of +1 to the task. 
C = 1 if DRUNM is rejected. 


Directive status returned: 

'D.RS8' if the specified address window was not mapped. 

‘D.RS87' if an invalid address window was specified by the 
task. 


Output fields in the window definition block are: 
W.NSTS = Indicator of any changes in mapping status 
WS.UNM = 1 if DRUNM successfully unmapped the window 


The DPB format is: 
WD. 00 -=- DIC(123.),DPB size(2.) 
WD. O1 -- Address of window definition block 


MODULE DESCRIPTIONS 


Entry Point - 


SDRSRF: :. 


Calls 


Input 


Output 


The DRSRF (Send by Reference) routine causes the system to 
create a formatted packet that includes a reference to a 
specified region and additional optional information which 
is supplied by the issuing task. The sender task must 
have the access specified in the reference. The 
referenced region is attached to the receiving task. 


SCEFN, SACHKP, SSRATT, SALPKT, $CRATT, S$QINSF, S$DASTT, 
SDRDSE, $DEPKT 


RO = Address of the TCB of the receiver task 

Rl = Address of the task status word of the receiver task 
R2 = Address of the task status word of the current task 
R3 = Address of the EFN number in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Input fields in the window definition block are: 
W.NRID = ID of the region to be sent by reference 
W.NOFF = Offset word passed without checking 
W.NLEN = Length word passed without checking 
W.NSTS = Allowed access (defaults to access of sender 
task) 
WS.RED = 1 if read access is to be allowed 
WS.WRT = 1 if write access is to be allowed 
WS.EXT = 1 if extend access is to be allowed 
WS.DEL = 1 if delete access is to be allowed 
W.NSRB = Optional address of an 8-word buffer of 
additional information 


The DRSRF routine returns directive status and the PS to 
the task. 


C = 0 if DRSRF successfully completes execution. Also, 
DRSRF returns a directive status of +l. 


C = 1 if the DRSRF routine did not complete execution. 


Directive status returned: 

'D.RS1' if DRSRF could not allocate a send packet or 
attachment descriptor 

'D.RS2' if an attempt is made to send to an ACP task 

'D.RS16' if the desired access to the region is denied 

'D.RS86' if an invalid region ID was specified 

'D.RS97' if an invalid EFN number is specified 

'D.RS98' if the address check of the window definition 
block or send buffer fails 


There are no output fields in the window definition block. 


The format of the send by reference packet is: 


WD. 00 -- Receive gueuve thread 

WD. 01 -- TCB address if EFN was specified. Zero if the 
EFN was not specified. 

WD. 02 -- EFN mask; first word of sender task name 

WD. 03 -- EFN address; second word of sender task name 

WD. 04 -- Region ID (attachement descriptor address) 

WD. 05 -- Offset in region word 


WD. 06 -- Length of map -word 
WD. 07 == Status word 
WD. 08 through WD. 017 -- Contents of the send buffer 


Note 


Entry Point 
SDRRRF:: 


Calls 


Input 


Output 


Note 


Entry Point 
SDRGMX:: 


MODULE DESCRIPTIONS 


The DPB format is: 
WD. 00 -- DIC(69.),DPB size(5.) 
WD. 01 -- First half of receiver task name 


WD. 02 -=- Second half of receiver task name 
WD. 03 -- Optional event flag to set when receive occurs 
WD. 04 -- Address of the window definition block 


The DRRRF directive processing routine causes the system 
to dequeue the next receive by reference packet in the 
receive queue. DRRRF exits if there are no packets in the 
receive queue and the sending task requested an exit. 


SDRDSE, $SETM, SACHKP, SQRMVF, $DEPKT, $DRMAP 


R2 = Address of the task status word of the current task 
R3 = Address of the window definition block 

R4 = Address of the header of the current task 

RS = Address of the TCB of the current task 


Input fields in the window definition block are: 
W.NSTS = Control information. 
WS.MSP = 1 if received reference is to be mapped 
WS.RCX = 1 if task exit desired if DRRRF does not find 
packet 
W.NSRB = Optional address of 10-word buffer for additional 
information 


The DRRRF routine returns directive status and the PS to 
the task. 


C = 0 if DRRRF successfully completes execution. 
C = 1 if DRRRF is rejected. 


Directive status returned: 
'D.RS8' if receive by reference entry is not in the queue. 
'D.RS98' if the address check of the receive buffer fails. 


Output fields in the window definition block are: 
W.NRID = Assigned region ID of the referenced region 
W.NOFF = Offset word specified by sender task 
W.NLEN = Length word specified by sender task 
W.NSTS = Status word specified by sender task 

WS.RED = 1 if attached with read access 

WS.WRT = 1 if attached with write access 

WS.EXT = 1 if attached with extend access 

WS.DEL = 1 if attached with delete access 

WS.RRF = 1 if receive was successful 


The DPB format is: 


WD. 00 -~ DIC(81.),DPB size(2.) 
WD. 01 -- Address of 10-word buffer for additional 
information 


The DRGMX directive processing routine causes the system 
to return the mapping context of the task (to fill ina 
given number of window definition blocks). The total 
number of window blocks is in the task header. DRGMX does 
not return information on unused window blocks. 


Calls 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


SACHKP 


R2 = Address of the task status word of the current task 
R3 = Address of N window definition blocks 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


There are no input fields in the window definition blocks. 
DRGMX returns directive status and the PS to the task. 


C = 0 if DRGMX successfully completes execution. Also, 
DRGMX returns a directive status of +1. 


C = 1 if DRGMX is rejected. 


Directive status returned: 
'D.RS98' if the address check of the window blocks plus 
terminator word fails. 


Output fields in each window definition block are: 
W.NID = Address window ID of next established address 
window. 


W.NAPR = Base APR of the window 

W.NBAS = Virtual base address of the window 

W.NSIZ = Size of the address region 

W.NRID = Region ID if mapped or unmodified 

W.NOFF = Offset in region if mapped or unmodified 

W.NLEN = Length of map if mapped or unmodified 

W.NSTS = Necessary bits to restore mapping or 0 if not 


mapped 
WS.MAP = 1 if window is mapped 
WS.WRT = 1 if window is mapped with write access 


The DPB format is: 
WD. 01 -= Address of the N window definition blocks 


7.2.22 DRMKT Module 


DRMKT 


This module processes the MARK TIME and RUN directives. 


DRMKT contains the following directive processing 
routines: 


$DRMKT Declare significant event at specified time 
interval 
$DRRUN Generate a clock queue entry to reguest ae task 


at a specified time 


Macro Library Calls - 


CLKDF$ 


Define clock gueue control block offsets 


Entry Point 
SDRMKT: : 


Calls 


Input 


Output 


Note 


Entry Point 
SDRRUN:: 


Calls 


Input 


MODULE DESCRIPTIONS 


The directive processing routine, DRMKT, causes the system 
to declare a significant event at a specified time 
interval from issuing the directive. If an event flag is 
specified at the time the MARK TIME directive is issued, 
DRMKT clears the event flag immediately and then sets’ the 
event flag at the time of the significant event. 


If the issuing task specified an AST entry point, an 
asynchronous trap occurs at the time of the significant 
event. The PS, PC, directive status word, and the 
specified event flag number are pushed onto the stack when 
the specified AST is processed. 


SCVRTM 

RO = Event flag mask word 

Rl = Event flag mask address 

R2 = Address of the task status word of the current task 
R3 = Address of the third word in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRMKT returns directive status and the PS to the task. 


C = 0 if DRMKT successfully completes execution. Also, 
DRMKT returns a directive status of +l. 


C = 1 if DRMKT does not complete execution. 

Directive status returned: 

‘'D.RS1' if insufficient core is available to allocate the 
clock queue entry. 

The DPB format is: 


WD. 00 -- DIC(23.),DPB size(5.) 


WD. O01 -- Event flag number of event flag to be set 
WD. 02 -- Time interval magnitude 

WD. 03 -- Time interval units 

WD. 04 -- AST entry point address 


The DRRUN directive processing routine causes the system 
to generate a clock queue entry to cause a task to be 
requested at a specified delta time from issuance of the 
directive and, optionally, to repeat the request 
periodically. 


SUISET, SCVRTM, S$ALCLK, $CLINS 


RO = Address of the TCB of the task to be run 

Rl = Address of the task status word of the task to be run 
R2 = Address of the task status word of the current task 
R3 = Address of the partition name in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 
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Output 


Note 


MODULE DESCRIPTIONS 


The routine DRRUN returns directive status and the PS _ to 
the task. 


C = 0 if DRRUN successfully completes execution. Also, 
DRRUN returns a directive status of +1 to the task. 


C = 1 if DRRUN does not complete execution. 

Directive status returned: 

'D.RS1' if insufficient core is available to allocate the 
clock queue entry. 

The DPB format is: | 


WD. 01 -- First half of task name 
WD. 02 ~- Second half of task name 


WD. 03 -- Partition name (not supported but must be 
present) 

WD. 04 -- Partition name (not supported but must be 
present) 

WD. 05 -= Request priority (not supported but must be 
present) 

WD. 06 -- Request UIC 

WD. 07 -- Delta time magnitude 

WD. 10 -- Delta time units 

WD. 11 -- Reschedule interval magnitude 

WD. 12 -- Reschedule interval units 


7.2.23 DRPUT Module 


DRPUT 


DRPUT contains the following directive processing 
routines: 
$DRFEX Enable or disable floating-point ASTs for task 


SDRPUT Enable or disable power recovery ASTs for task 

SDRRRA Enable or disable receive-by-reference ASTs for 
task 

SDRRCV Enable or disable receive ASTs for task 


Macro Library Calls - 


HDRDFS 
TCBDFS 


Define task header offsets 
Define task control block offsets 


Entry Point - 


SDRFEX:: 


Calls 


Input 


The directive processing routine, DRFEX, causes the system 
to record that floating-point ASTs are either desired or 
not desired for the issuing task. 


None 


R2 = Address of the task status word of the current task 
R3 = Address of the AST address in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Output 


Note 


Entry Point 
SDRPUT:: 


Input 


Output 


Note 


Entry Point 


SDRRRA:: 


Calls 


Input 


MODULE DESCRIPTIONS 


DRFEX returns directive status and the PS to the task. 


C = 0 if DRFEX successfully completed execution. Also, 
DRFEX returns a directive status of +l to the task. 


C = 1 if DRFEX does not complete execution. 


Directive status returned: 
'p.RS8' if ASTs are already not desired 
'p.RS80' if an AST routine issued this directive 


The DPB format is: 
WD. 00 -- DIC(111.),DPB size(2.) 
WD. O01 -- AST entry point address or zero 


DRFEX shares common code with DRRCV. 


The directive processing routine, DRPUT, causes the system 
to record that power recovery ASTs either are desired or 
are not desired for the issuing task. 


R2 = Address of the task status word of the current task 
R3 = Address of the AST address in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRPUT returns directive status and the PS to the task. 


C = 0 if DRPUT succesfully completes execution. Also, 
DRPUT returns a directive status of +1 to the task. 


C = 1 if DRPUT does not complete execution. 


Directive status returned: 
'p.RS8' if ASTs are already not desired 
'p.RS80' if an AST routine issued the DRPUT directive. 


The DPB format is: 
WD. 00 -— DIC(109.),DPB size(2.) 
WD. O01 -- AST entry point address or zero 


DRPUT shares common code with DRRCV. 


The directive processing routine, DRRRA, causes the system 
to record that receive-by-reference ASTs either are 
desired or are not desired for the issuing task. 


None 


R2 = Address of the task status word of the current task 
R3 = Address of the AST address in the DPB 

R4 = Address of the header of the current task 

RS = Address of the TCB of the current task 


MODULE DESCRIPTIONS 


Output DRRRA returns directive status and the PS to the task. 


C = 0 if DRRRA successfully completes execution. Also, 
DRRRA returns a directive status of +1 to the task. 


C = 1 if DRRRA does not complete execution. 
Directive status returned: 


'pD.RS8' if ASTs are already not desired. 
'D.RS80' if an AST routine issued the DRRRA directive 


Note The DPB format is: 
WD. 00 -- DIC(21.),DPB size(2.) 
WD. 01 -~ AST entry point address or zero 


Entry Point - 

SDRRCV:: The directive processing routine, DRRCV, causes the system 
to record that receive ASTs either are desired or are not 
desired for the issuing task. 


Calis SALCLK, SDECLK 
Input R2 = Address of the task status word of the current task 
R3 = Address of the AST address in the DPB 
R4 = Address of the header of the current task 
R5 = Address of the TCB of the current task 
Output DRRCV returns directive status and the PS to the task. 
C = 0 if DRRCV successfully completed. Also, DRRCV 


returns a directive status of +l to the task. 


C = 1 if DRRCV does not complete execution. 


Note The DPB format is: 
WD. 00 -- DIC(107.),DPB size(2.) 
WD. 01 -- AST entry point address or zero 


7.2.24 DRQIO Module 


DRQIO DRQIO contains the following directive processing 
routines: 
$DRQIO Place I/O request in a queue of priority ordered 

requests 

$DRGRG Place I/O packet in a controller queue 

Macro Library Calls - 

FL1DFS Define Files-11 control block offsets 

HWDDF$ Define hardware registers 

PKTDFS Define I/O packet offsets 

TCBDFS Define task control block offsets 

PCBDFS$ Define partition control block offsets 


Entry Point - 

SDRQIO:: The directive processing routine, DRQIO, places an I/O 
request in a queue of priority ordered reguests for a 
device or unit specified by a logical unit number. If the 
task specifies an event flag with a QIO and WAIT (QIOW) 
directive, the task is put into a wait state to wait for 
the specified event flag to be set upon the occurrence of 
the significant event. 


MODULE DESCRIPTIONS 
Calls SMPLUN, STKWSE, SCEFN, S$ACHKW, S$ALPKT, SCEFI, SDRWFS, 
SRELOC, S$ACHKB, $MPPHY, SIOKIL, $ACHCK, SMPLND 
Input R2 = Address of the task status word of the current task 
R3 = Address of the I/O function code in the DPB 
R4 = Address off the header of the current task 
R5 = Address of the TCB of the current task 
Output DRQIO returns directive status and the PS to the task. 


C = 0 if DRQIO successfully completes execution. Also, 
DRQIO returns a directive status of +1 to the task. 


C = 1 if DRQIO is rejected. 


Directive status returned: 
'D.RS5' if the specified LUN is not assigned. 


Note The DPB format is: 
WD. 00 -- DIC(1./3.),DPB size(12.) 
WD. O01 -- I/O function code 
WD. 02 -- LUN and unused byte 
WD. 03 -- Event flag number and priority (priority is 
ignored) 
WD. 04 -= Address of I/O status block 
WD. 05 -- Address of AST service routine 
WD. 06 -- Parameter 
WD. 07 -- Parameter 
WD. 10 -- Parameter 


WD. ll -- Parameter 
WD. 12 -- Parameter 
WD. 13 -- Parameter 


AN & WHE 


Entry Point - 

SDRQRQ:: The DRQRQ routine is called to insert an I/O packet in a 
controller queue and call the driver to start activity on 
the device. 


Calls SQINSP, @D.VINI(R5) call to driver initiator or device 
initiator, SDEPKT, S$IOFIN, PPRM, $ALOCB, SACHCK, $RELOM, 
RQOPRM 

Input Rl = Address of the I/O packet 


R5 = Address of the unit control block 


Output DRQRQ places the I/O packet in the controller gueue = and 
starts activity on the device. 


Note This routine destroys the contents of R4. 


7.2.25 DRRAS Module 


DRRAS DRRAS contains the following directive processing 
routines: 
SDRREC Process RECEIVE DATA and RECEIVE DATA OR EXIT 

directives. 

SDRSND Process SEND DATA directive. 

Macro Library Calls - 

HDRDFS Define task header offsets 

TCBDF$ Define task control block offsets 


Entry Point 
SDRREC:: 


Calls 


Input 


Output 


Note 


Entry Point 
SDRSND: : 


Calls 


Input 


Output 


“ 


Note 


MODULE DESCRIPTIONS 


This routine causes the system to dequeue a data block 
from the issuing task's receive queue. If the issued 
directive was RECEIVE DATA OR EXIT, the task exits if no 
data is queued. 


SACHKP, SQRMVF, SDEPKT 


R2 = Address of the task status word of the current task 
R3 = Address of the second word in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


The DRREC routine returns directive status and the PS _ to 
the task. 


C = 0 if DRREC successfully completes execution. Also, 
DRREC returns a directive status of +l to the task. 


C.= 1 if DRREC does not complete execution. 


Directive status returned: 
'p.RS8' if no data is gueved in the task's receive gueue. 


The DPB format is: 

WD. 00 -— DIC(75. or 77.),DPB size(4.) 

WD. 01 -- First half of the task name - Not supported but 
must be present 

WD. 02 -~ Second half of the task name - Not supported but 
must be present 

WD. 03 -- Address of a fifteen word receive buffer 


This directive processing routine causes the system to 
queue a thirteen word data block in a specified task's 
receive gueue. 


SACHKP, S$SETF, S$ALPKT, S$QINSF, S$DASTT, S$DRDSE 


RO = Address of the TCB of the receiver task 

Rl = Address of the task status word of the receiver task 
R3 = Address of the data block address in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRSND returns directive status and the PS to the task. 


C = 0 if DRSND successfully completes execution. Also, 
DRSND returns a directive status of +l to the task. 


C = 1 if DRSND does not complete execution. 


Directive status returned: 

'D.RS1' if insufficient core is available to queue the 
data block. 

'D.RS2' if the receiver task is an ancillary control 
processor. 


The DPB format is: 


WD. 00 -- DIC(71.),DPB size(5.) 

WD. 01 -- First half of receiver task name 
WD. 02 -- Second half of receiver task name 
WD. 03 -- Address of thirteen word data block 
WD. 04 -- Event flag number (optional) 


MODULE DESCRIPTIONS 


7.2.26 DRREG Module 


DRREG The directive processing module, DRREG, contains the 
following routines: 
SDRCRR:: Create a region 
SDRATR: : Attach a region 
SDRDTR: : Detach a region 
SDETRG:: Detach a region by attachment descriptor 
address 


These directive processing routines receive, as input, a 
pointer to a region definition block that is a 
communication area between the issuing task and _ the 
Executive. 


The format of the region definition block is: 


R.GID REGION ID 

R.GSIZ SIZE OF REGION (32W BLOCKS) 
R.GNAM NAME OF REGION (RAD50) 

R.GPAR REGION'S MAIN PARTITION NAME (RAD50) 
R.GSTS REGION STATUS WORD 

R.GPRO PROTECTION CODE OF REGION 


Macro Library Calls - 


HDRDFS Define header and window block offsets 
PCBDFS$ Define PCB and attachment descriptor offsets 
RDBDF$ Define region definition block offsets 
TCBDFS Define TCB offsets 


Entry Point - 
SDRCRR:: This directive processing routine causes the system to 
create a region and optionally to attach it. 


Calls SSRNAM, ATT, SALOCB, $SFNDSP 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


R2 = Address of the task status word of the current task 
R3 = Address of the region definition block 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Input fields in the region definition block are: 

R.GSIZ = Size of region to create 

R.GNAM = Name of region to create or 0 for no name 

R.GPAR = Name of system partition in which to allocate 
region or zero (0) for main system partition of 
task 

R.GSTS = Control information 

RS.NDL = 1 if region should not be deleted on last 
detach 


RS.ATT = 1 if created region should be attached 

RS.RED = 1 if read access is desired on attach 

RS.WRT = 1 if write access is desired on attach 

RS.EXT = 1 if extend access is desired on attach 

RS.DEL = 1 if delete access is desired on attach 
R.GPRO = Protection code for region (DEWR,DEWR,DEWR,DEWR) 


DRCRR returns directive status and the PS to the task. 


C = 0 if DRCRR successfully completed execution. Also, 
DRCRR returns a directive status of +1 to the task. 


C = 1 if DRCRR does not complete execution. 


Directive status returned: 

'D.RS1' if a PCB or attachement descriptor could not be 
allocated 

'D.RS16' if the desired access is denied in the 
attachement stage 

'D.RS84' if the specified partition in which the region is 
to be allocated does not exist, or if no 
partition name has been specified and RS.ATT is 
zero. 


Output fields in the region definition block are: 
R.GID = Assigned region ID (RS.ATT = 1) 
R.GSTS = Directive completion information 

RS.CRR = 1 if region was created 


The DPB format is: 
WD. 00 -- DIC(55.),DPB size(2.) 
WD. 01 -- Address of region definition block 


MODULE DESCRIPTIONS 


Entry Point - 


SDRATR: : 


Calls 


Input 


Output 


Note 


Entry Point 


DRDTR: : 


Calls 


Input 


The directive processing routine, DRATR, causes the system 
to attach the specified region to the current task. 


SSRNAM, SCKACC, $CRATT 


R2 = Address of the task status word of the current task 
R3 = Address of the region definition block 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Input fields in the region definition block are: 
R.GNAM = Name of the region to which to attach or zero (0) 
for task region 
R.GSTS = Desired access to region 
RS.RED = 1 if read access is desired 
RS.WRT = 1 if write access is desired 
RS.EXT = 1 if extend access is desired 
RS.DEL = 1 if delete access is desired 


DRATR returns directive status and the PS to the task. 


C = 0 if DRATR successfully completes execution. Also, 
DRATR returns a directive status of +l to the task. 


C = 1 if DRATR does not complete execution. 


Directive status returned: 
'D.RS1' if an attachment descriptor cannot be allocated. 
'D.RS84' if the specified region name does not exist. 


Output fields in the region definition block are: 
R.GID = Assigned region ID 
R.GSIZ = Size of attached region 


The DPB format is: 
WD. 00 -—- DIC(57.),DPB size(2.) 
WD. 01 -- Address of region definition block 


The directive processing routine, DRDTR, causes the system 
to detach the specified region, unmapping it if necessary. 


SSRATT, SUNMAP 


R2 = Address of the task status word of the current task 
R3 = Address of: the region definition block 

R4 = Address of the headee of the current task 

R5 = Address of the TCB of the current task 


Input fields in the region definition block are: 
R.GID = Region ID of the region to be detached 
R.GSTS = Control information 
RS.MDL = 1 if region should be marked for delete on the 
last detach 
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Output 


Entry Point 
SDETRG:: 


Calls 
Input 


Output 


MODULE DESCRIPTIONS 


DRDTR returns directive status and the PS to the task. 


C = 0 if DRDTR successfully completes execution. Also, 
DRDTR returns a directive status of +l to the task. 


C = 1 if DRDTR does not complete execution. 


Directive status returned: 

'D.RS16'if an attempt is made to mark the region for 
delete without delete access 

'D.RS86' if an invalid region ID is specified or if an 
attempt is made to detach region zero (0). 


Output fields in the region definition block are: 


R.GSTS = Indication of any changes in mapping context 
RS.UNM = 1 if any windows were unmapped 


The directive processing routine, DETRG, detaches a task 
from a region and deallocates the attachment descriptor. 
The last time DETRG detaches the region it checks it for 
deletion and calls S$NXTSK if needed. 

SQRMVT, SRLPR1, $DEACB 

R5 = Address of attachment descriptor 

DETRG modifies RO, Rl, R2, and R3. 


All other output is the same as the DRDTR routine. 


7.2.27 DRREQ Module 


DRREQ 


The directive processing module, DRREQ, causes the system 
to request the execution of a specified task. 


Macro Library Calls - 


TCBDF$ 


Entry Point 
SDRREQ:: 
Calls 


Input 


Define task control block offsets 


Reguest the execution of a specified task. 


$TSKRP, SUISET 


RO = Address of the TCB of the task to be requested 
Rl = Address of the task status word of the task to be 
requested 


R2 = Address of the task status word of the current task 
R3 = Address of the partition name in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Output 


Note 


MODULE DESCRIPTIONS 


DRREQ returns directive status and the PS to the task. 


C = 0 if DRREQ successfully completes execution. Also, 
DRREQ returns directive status of +l to the task. 


C = 1 if DRREQ does not complete execution. 

Directive status returned: 

'D.RS1' if partition control block cannot be allocated 
'D.RS7' if specified task is already active 


The DPB format is: 
WD. 00 -= DIC(11.),DPB size(7.) 


WD. 01 -- First half of task name 

WD. 02 -- Second half of task name 

WD. 03 -- Partition name (not supported, but must be 
present) 

WD. 04 -- Partition name (not supported, but must be 
present) 

WD. 05 -= Request priority (not supported, but must be 
present) 

WD. 06 -- Request UIC 


7.2.28 DRRES Module 


DRRES 


The directive processing module, DRRES, contains the 

following directive processing routines: 

SDRRES Resume execution of a task that has issued a 
suspend directive 

SDRSPN Suspend the execution of the task that issued 
this directive 

SDRATP Change the task priority of the specified task 


Macro Library Calls - 


HDRDFS 
PKTDFS 
PCBDF$ 
TCBDFS 


Entry Point 
SDRRES:: 


Calls 


Input 


Define task header offsets 

Define I/O packet offsets 

Define partition control block offsets 
Define task control block offsets 


The directive processing routine, DRRES, causes the system 
to resume the execution of a task that issued the suspend 
directive. 

$SETCR 


Address of the TCB of the task to be resumed 


yw 
oS 
Hou 


R1 Address of the task status word of the task to be 
resumed 

R2 = Address of the task status word of the current task 

R3 = Address of the last word in the DPBt+2 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


Output 


Note 


Entry Point 


SDRSPN:: 


Calls 


Input 


Output 


Note 
Entry Point 
SDRATP:: 


Calls 


Input 


Output 


Note 


_R2 
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DRRES returns directive status and the PS to the task. 


C = 0 if DRRES successfully completes execution. Also, 
DRRES returns a directive status of +1 to the task. 


C = 1 if DRRES is rejected. 


Directive status returned: 
'D.RS7' if the specified task is not active 
'D.RS8' if the specified task is not suspended 


The DPB format is: 

WD. 00 -- DIC(47.),DPB size(3.) 
WD. O1 -= First half of task name 
WD. 02 --— Second half of task name 


The directive processing routine, DRSPN, causes the system 
to suspend the execution of the issuing task. 


SSETRT 


R2 Address of the task status word of the current task 


R3 = Address of the last word in the DPB+2 
R4 = Address of the header of the current task 
R5 = Address of the TCB of the current task 


DRSPN returns directive status and the PS to the task. 
C = 0 with a directive status of 'D.RS22' 


The directive processing routine, DRATP, causes the system 
to change the task priority of the specified task. 


SMPLNE, SACTRM, SACTTK, SQRMVT, $NXTSK, $DRDSE, SQINSF, 
SQRMVF, SQINSP 


RO = Address of the TCB of the task to be altered 
Rl = Address of the task status word of the task to be 
altered 


= Address of the task status word of the current task 
R3 = Address of the last word in the DPB 
R4 = Address of the header of the current task 
R5 = Address of the TCB of the current task 


DRSPN returns directive status and the PS to the task. 


C = 0 if DRSPN successfully completes execution. Also, 
DRSPN returns directive status of +l to the task. 


C = 1 if DRSPN does not complete execution. 
Directive status returned: 

'pD.RS7' if the task is not active 

'pD.RS95' if the new specified priority is invalid 


The DPB format is: 


WD. 00 -= DIC(9.),DPB size(4.) 
WD. Ol -- First half of task name 
WD. 02 -- Second half of task name 


WD. 03 -- New priority 


MODULE DESCRIPTIONS 


7.2.29 DRSED Module 


DRSED 


The directive processing module, DRSED, contains the 
following directive processing routines: 

SDRCEF Clear event flag 

SDRDSE Declare a significant event 

$DRRAF Read all event flags 

SDRSEF Set event flag 

STKWSE Task wait for significant event 

SDRWSE Wait for significant event 

SDRWFL Wait for LOGICAL OR of event flags 

SDRWFS Wait for single event flag 


Macro Library Calls - 


HDRDFS 
TCBDFS 


Entry Point 


SDRCEF:: 


Calls 


Input 


Output 


Note 


Entry Point 
SDRDSE:: 


Calls 


Input 


Output 


Note 


Define task header offsets 
Define task control block offsets 


The directive processing routine, DRCEF, causes the system 
to report the polarity of an event flag and then clear the 
event flag. 


None 

RO = Event flag mask word 

Rl = Event flag mask address 

R2 = Address of the task status word of the current task 
R3 = Address of the last word in the DPB+2 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRCEF returns directive status and the PS to the task. 


C = 0 with a directive status of 'D.RSOO' if the flag was 
clear or 'D.RS22' if the flag was set. 


The DPB format is: 


WD. 00 -- DIC(31.),DPB size(2.) 
WD. O01 -- Event flag number of flag to be cleared 


The directive processing routine, DRDSE, causes the system 
to declare a significant event. 


This directive is also called as a subroutine. 
None 


R2 = Address of the task status word of the current task 


_R3 = Address of the last word in the DPBt+2 


R4 = Address of the header of the current task 
R5 = Address of the TCB of the current task 


DRDSE returns directive status and the PS to the task. 
C = 0 with a directive status of +1 


The DPB format is: 
WD. 00 -=~ DIC(35.),DPB size(l.) 


Entry Point 
SDRRAF: : 


Calls 


Input 


Output 


Note 


Entry Point 
SDRSEF:: 


Calls 


Input 


Output 


Note 


Entry Point 
STKWSE:: 


Calls 
Input 


Output 
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The directive processing routine, DRRAF, causes the system 
to fill a 4-word buffer with the task's local and the 
global event flags. 


SACHKP 


R2 = Address of the task status word of the current task 
R3 = Address of the buffer address in the DPB 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRRAF returns directive status and the PS to the task. 


C = 0 if DRRAF successfully completes execution. Also, 
DRRAF returns a directive status of +1 to the task. 
C = 1 if DRRAF does not complete execution. 


Directive status returned: 
'D.RS98' if the buffer is outside of the issuing task's 
address space 


The DPB format is: 
WD. 00 == DIC(39.),DPB size(2.) 
WD. O01 -= Address of a 4-word buffer 


The directive processing routine, DRSEF, causes the system 
to report on the polarity of an event flag and then set 
the event flag. 


None 

RO = Event flag mask word 

Rl = Event flag mask address 

R2 = Address of the task status word of the current task 
R3 = Address of the last word in the DPBt2 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


DRSEF returns directive status and the PS to the task. 


C = 0 with a directive status of 'D.RSOO' if the flag was 
clear or 'D.RS22' if the flag was set 


The DPB format is: 
WD. 00 -=- DIC(33.),DPB size(2.) 
WD. 01 -- Event flag number of flag to be set 


This routine is called from within the Executive to 
execute a wait for significant event directive for the 
current task. This routine shares code that is common 
with the SDRWSE routine. 


None 
None 


This routine executes the wait for significant event 
directive and returns to the calling routine. 


Entry Point 
SDRWSE:: 


Calls 


Input 


Output 


Note 


Entry Point 
SDRWFL: : 


Calls 


Input 


Output 


Note 


Entry Point 
SDRWFS: : 


Calls 
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The directive processing routine, DRWSE, causes the system 
to suspend the execution of the issuing task until the 
next significant event occurs. 


SSETRQ 


R2 
R3 
R4 
R5 


Address of the task status word of the current task 
Address of the last word in the DPB+2 

Address of the header of the current task 

Address of the TCB of the current task 


DRWSE returns directive status and the PS to the task. 
C = 0 with a directive status of +1 


The DPB format is: 
WD. 00 -= DIC(49.),DPB size(l.) 


The directive processing routine, DRWFL, causes the system 
to suspend the execution of the task that issued the 
directive until any of the specified event flags become 
set. 


Address of the task status word of the current task 
Address of the second word in the DPB 

Address of the header of the current task 

Address of the TCB of the current task 


DRWFL returns directive status and the PS to the task. 


C = 0 if DRWFL successfully completes execution. Also, 
DRWFL returns a directive status of +l to the task. 


C = 1 if DRWFL does not complete execution. 

Directive status returned: 

'D.RS97' if an illegal event flag set or a zero (0) event 
flag mask is specified by the task. 


The DPB format is: 
WD. 00 ~-- DIC(43.),DPB size(3.) 


WD. O01 -- Event flag set indicator 
WD. 02 -- Event flag mask word 

The event flag sets are: 

Set 0 -- Event flags l. - 16. 

Set 1 -- Event flags 17. - 32. 

Set 2 -- Event flags 33. - 48. 

Set 3 -- Event flags 49. ~— 64. 


The directive processing routine, DFWFS, causes the system 
to suspend the execution of the issuing task until a 
specified event flag is set. 


SSETRT 


Input 


Output 


Note 
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RO = Event flag mask word 

Rl = Event flag mask address 

R2 = Address of the task status word of the current task 
R3 = Address of the last word in the DPB+2 

R4 = Address of the header of the current task 

R5 = Address of the TCB of the current task 


The DRWFS routine returns directive status and the PS_ to 
the task. 


C = 0 with a directive status of +l. 
The DPB format is: 


WD. 00 -- DIC(41.),DPB size(2.) 
WD. 01 -- Event flag number of flag to wait for 


7.2.30 DRSST Module 


DRSST 


The directive processing module, DRSST, specifies SST 
vectors of service routine entry points for use by 
intra-task debugging aids or the issuing task. 


DRSST contains the following directive processing 

routines: 

SDRSDV Record address and length of a vector of SST 
service routine entry points for debugging aid. 

SDRSTV Record address and length of a vector of SST 
service routine entry points for issuing task. 


Macro Library Calls - 


HDRDFS$ 


Define task header offsets 


Entry Point - 


SDRSDV:: 


Calls 


Input 


Output 


The directive processing routine, DRSDV, records the 
address and length of a vector of SST service routine 
entry points for use by an intra-task debugging aid (ODT). 


= Address of the task status word of the current task 
R3 = Address of the second word in the DPB 

= Address of the header of the current task. 

= Address of the TCB of the current task 


DRSDV returns directive status and the PS to the task. 


C = 0 if DRSDV successfully completes execution. Also, 
DRSDV returns a directive status of +l to the task. 


C = 1 if DRSDV does not complete execution. 


Directive status returned: 

'D.RS98' if part of the vector is outside of the issuing 
task's address space, a vector address of zero is 
specified, or the vector size is greater than 31.’ 
words. 


Note 


MODULE DESCRIPTIONS 


The DPB format is: 
WD. 00 -= DIC(103.),DPB size(3.) 
WD. 01 -- Address of the SST vector 


~ WD. 02 -— Number of entries in the SST vector 


Entry Point 
SDRSTV:: 


Calls 


Input 


Output 


Note 


The SST vector format is: : 

WD. 00 -- Traps to 4 (odd address, non-existent memory, 
etc.) 

WD. 01 -- Segment fault 

WD. 02 -- Trace trap (T-bit) or execution of BPT 
instruction 

WD. 03 .-- Execution of an IOT instruction 

WD. 04 -- Execution of an illegal or reserved instruction 

WD. 05 -= Execution of a non-RSX EMT instruction 

WD. 06 -- Execution of a TRAP instruction 

WD. 07 -- PDP 11/40 floating point exception fault 


The directive processing routine, DRSTV, causes the system 
to record tha address and length of a vector of SST 
service routine entry points for use by the issuing task. 


SACHKW 


R2 
R3 
R4 
R5 


Address of the task status word of the current task 
Address of the second word in the DPB 

Address of the header of the current task 

Address of the TCB of the current task 


DRSTV returns directive status and the PS to the task. 


Cc = 0 if DRSTV successfully completes execution. Also, 
DRSTV returns a directive status of +1 to the task. 


C = 1 if DRSTV does not complete execution. 


Directive status returned: 

'D.RS98' if part of the vector is outside of the issuing 
task's address space, a vector address of zero is 
specified, or the vector size is greater than 31. 
words. 


The DPB format is: 

WD. 00 -- DIC(105.),DPB size(3.) 

WD. 01 -- Address of the SST vector 

WD. O02 -~ Number of entries in the SST vector 


The SST vector format is: 
WD. 00 -- Traps to 4 (odd address, non-existent memory, 


etc.) 

WD. O01 -- Segment fault 

WD. 02 -- Trace trap (T~bit) or exectution of a BPT 
instruction 

WD. 03 -- Execution of an IOT instruction 

WD. 04 -=- Execution of an illegal or reserved instruction 


WD. 05 -- Execution of a non-RSX EMT instruction 
WD. 06 -=- Execution of a TRAP instruction 
WD. 07 -—- PDP 11/40 floating-point exception fault 


7.2.31 


ERROR 


MODULE DESCRIPTIONS 


ERROR Module 


This is the error logging module. This module contains 
the following routines: 


SALEMB 


Allocate an error message block 

SALEB1 - Allocate an error message block (alternate entry) 
SBMSET - Set a driver's bit in the I/O active bit map 
SDTOER - Device timeouts 

S$DVCER - Device error bit set 

SDVERR - Device error bit set (temporary label) 

NSIER: . - Nonsense interrupt error processing 


SQEMB ~ Queue an error message block (EMB) 


Macro Library Calls - 


HWDDFS 
CLKDFS$ 
HDRDFS 
PCBDFS 
PKTDFS 
TCBDFS 


Entry Point 
SALEMB:: 
SALEB1L:: 


Calls 


Input 


Output 


Note 


Entry Point 
SBMSET:: 


Calls 
Input 


Output 


Define CPU registers 

Define clock offsets and codes 

Define task header offsets 

Define partition offsets 

Define I/O packet offsets 

Define task control block offsets and codes 


Error servicing routines call this routine. It 

counts the occurence of the error and tries to allocate a 
core block from the pool. If the core block is allocated, 
it fills in the error code, the time, and the error 
seguence number. Otherwise, it sets the C-bit = l. 


SALOCB 
2(SP) = Error code 
O(SP) = Return 
Rl = Size of the EMB to allocate 
If the C-bit is 0: 
= Address of the first unfilled byte 
(Rl) = Address of the EMB 
If the C-bit = 1, SALEMB did not complete execution. 


SALEMB destroys R2 and R3 when it calls SALOCB. 


This co-routine raises the processor priority to seven and 
sets the mask in the SCB in S$IOABM. It lets the calling 
routine start the function, then allows interruptions. 
@(SP)+ -- to call the calling routine 

R4 = Address of the SCB 


SIOABM is modified and priority 7 established. 


Entry Point 
SDTOER:: 


Calls 


Input 


Output 


Note 


Entry Point 
SDVCER:: 


Calls 
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This is the error message block (EMB) formatting routine. 
The driver recognizes timeout errors, On the first 
occurrence of an error, $DTOER attempts to log it. If 
errors occur on retries, they are not logged. 


SDTOER pushes the error code EC.DTO on the stack, sets the 
error in progress bit in the SCB, calculates the length of 
the reguired EMB, and calls $ALEMB. If SALEMB fails to 
allocate a packet for any reason, $DTOER exits and $DVCER 
clears the pointer in the SCB to the EMB. 


Otherwise, $DVCER copies the saved $IOABM from the SCB_ to 
the EMB and saves a pointer to the EMB in the SCB. $DVCER 
puts the error information, including device registers, 
into the EMB and executes a RETURN. The contents of the 
CSR that is saved is unchanged from the time of timeout. 
After the CSR is saved, device interrupts are disabled and 
CPU priority is lowered to PRO. 


None 


(R2) = Address of the CSR 
(R4) = Address of the SCB 


C = 0 if the function was not a user-mode diagnostic 
function. The EMB is filled and the SCB contains a 
pointer to it. The error in progress flag is set in 
the SCB. 


C = 1 if the function was a user-mode diagnostic function. 
Only interrupt enable is cleared and the priority is 
lowered to 0. 


If the system supports diagnostics, Rl will be set to the 
I/O packet address. If diagnostics are not supported, all 
registers are cleared. 


This is the EMB formatting routine and it is used when the 
device driver recognizes device error bit errors. On the 
first occurence of an error, $DVCER attempts to log it. 
If errors occur on retries, they are not logged. 


SDVCER pushes the error code, EC.DVC, on the stack, sets 
the error in progress bit in the SCB, calculates the 
length of the required EMB, and calls SALEMB. If SALEMB 
fails to allocate a packet for any reason, S$DVCER clears 
the pointer in the SCB to the EMB and exits. 


Otherwise, SDVCER copies the saved SIOABM from the SCB_ to 
the EMB and saves a pointer to the EMB in the SCB. SDVCER 
puts the error information, including the device 
registers, into the EMB and executes a RETURN. 


SALEMB 


Input 


Output 


Entry Point 
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(R4) = Address of the SCB 
After S$DVCER fills the stack, the stack contains: 


QO(SP) = Error code 
2(SP) = CSR address or 0 
4(SP) = Saved RO 

6(SP) = Saved Rl 

10(SP) = Saved R2 

12(SP) = Saved R3 

14(SP) = Return 


If successful, the EMB is filled and the SCB contains a 
pasate to it. An error in progress bit is set in the 
SCB. 


Otherwise, the occurrence of the error is counted only. 


SNSO::throughSNS7:: 


Entry Point 
SQEMB:: 


Input 
Output 


Note 


These are the nonsense interrupt identifier routines. One 
of a group of 16 unused vectors points to each of these 
routines. The vectors are sub-coded in the PS condition 
codes. Each routine consists of a CALL to NSIER: and a 
word containing an indentifying number. 


This is the common entry point for all EMBs. $QEMB queues 
the EMB FIFO in the error gueve. SQEMB awakens the ERROR 
logger task if there are enough bytes of EMBs in the pool. 
If the queue is empty, S$QEMB makes a schedule request to 
write a queued EMB within a time limit. Otherwise, $QEMB 
executes a RETURN. 


(Rl) = Address of the EMB 
None 


SQEMB destroys registers RO through R3 


7.2.32 INITL Module 


INITL 


The INITL module contains the transfer point of the 
resident executive. When the system is initially booted, 
control transfers to this routine to initialize and start 
up the system. 


The INITL module contains the following labels: 


- $POOL:: Start of the system pool space 


SYSMG: The log on message "RSX-11M V3.1 BL", 

SYSID: The system identification (4 bytes) 

DEVMG: The message: /DEVICE dduu: NOT IN 
CONFIGURATION/ 

OPMSG: Subroutine to write a message to the system 
console terminal 

TRPRT: Non-existent memory - trap routine 

SSYBEG: Beginning of dynamic storage region 


SSYTOP: Last address in the Executive 


Macro Library Calls - 


HWDDFS$ 


MODULE DESCRIPTIONS 


The INITL routine resets the processor and saves’ the 
following information about the loading device: 

@® Unit number 

e Logical block number (LBN) of load image 

e Device name 

e Length of load file 


The INITL.module sets up the basic operating parameters of 


the 


system using conditional assemblies for Memory 


Management, 11/70 Extended Memory Support, 11/70 Cache 
Parity Support, and Real Time Clock for LSI-ll. 


Define hardware registers 


Entry Point - 
This is the system start up and initialization routine. 


SINITL:: 


Calls 
Input 


Output 


122.33 


IOSUB 


SDIV, SDEACB 


None ~- Processor reset 


None - System cperating parameters initialized 


IOSUB Module 


The IOSUB module contains the following routines: 


SACHKP 
SACHKW 
SACHK2 
SACHKB 
SACHCK 
SASUMR 
SCEFN 

SCEFI 

$DEUMR 
$DQUMR 
$DVMSG 
SGTPKT 
SBLKCK 
SBLKC1 
SIODON 
SIOALT 
SIOFIN 
SIOKIL 
SLCKPR 
SMPLNE 
SMPLUN 
SMPPHY 
SMPPKT 
SMPUBM 
SMPVBN 
SRELOC 
SRELOM 
SRLCH 

$RQCH 

SSCDVT 
SSCDV1 
SSTMAP 
SECCOR 
$RELOP 


Address check parameter block 

Address check parameter block; word aligned 
Address check 2-byte directive parameter block 
Address check; byte aligned 

Address check; word aligned 

Assign UNIBUS mapping registers 

Convert event flag number for directive 
Convert event flag number for I/0 
Deassign UNIBUS mapping registers 
Dequeue from UMR wait 

Device message output 

Get I/O packet from request block 

Check logical block 

Check logical block (alternate entry) 
I/O done 

I/O done (alternate entry) 

I/O finish 

I/O kill 

Lock and unlock processing routine 

Map logical unit number for exit 

Map logical unit number 

Map to physical address 

Map J:/O packet function 

Map UNIBUS to memory 

Map virtual block number 

Relocate user virtual address 

Relocate and map address 

Release channel 

Request channel 

Scan device tables 

Scan device tables (alternate entry) 
Set up UNIBUS mapping address 

Common ECC correction code for RP04/RK06 
Relocate UNIBUS phisical address 
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SCRPAS Common register pass routine 
$MUL Integer multiply magnitude numbers 
SWTUMR Wait for change in UMR state 


_$DIV Integer divide magnitude numbers 


Macro Library Calls - 


F11DFS 
HDRDFS 
HWDDFS 
PCBDFS 
PKTDFS 
TCBDFS$ 


Define window and lock block offsets 
Define task header offsets 

Define hardware registers 

Define partition control block offsets 
Define I/O packet offsets 

Define task control block offsets 


Entry Points - 


SACHKP:: 
SACHKW: : 
SACHK2:: 


Calls 


Input 


Output 


Note 


Executive code calls these routines to check the address 
of a task specified parameter block to ensure that the 
block is within the task's address space and is correctly 
aligned. If either check fails, the routines return a 
directive status of 'D.RS98'. 


SACHCK, $RELOC 


RO = Starting address of the block to be checked 
Rl = Length of the block to be checked in bytes 


These routines return a directive status of 'D.RS98' to 
the calling routine if either check fails. 


Registers RO and R3 are preserved across the call. 


Entry Points - 


SACHKB:: 
SACHCK:: 


Input 


Output 


Note 


Entry Point 
SASUMR 


Calls 


Input 


Executive code calls these routines to check the address 
of a block of memory to be sure it lies within the address 
space of the current task. 


RO = Starting address of the block to be checked 
Rl = Length of the block (in bytes) to be checked 


C = 0 if address check succeeded. 
C = 1 if address check failed. 


Registers RO and R3 are preserved across the call 


This routine assigns UNIBUS mapping registers (UMRS). It 
assigns a contiguous set of UMRs. For the sake of speed, 
the link word of each mapping assignment block points to 
the UMR address (2nd) word of the block, not the first 
word, A linked list of mapping assignment blocks 
represents the current state of UMR assignment. Each 
block contains the address of the first UMR assigned and 
the number of UMRsS assigned times 4. The blocks are 
linked in the order of increasing first UMR address. 


None 


RO = Address of a mapping register assignment block 
M.UMRN(RO) = Number of UMRS required times 4 


Output 


Note 
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C = 0 if SASUMR successfully assigned the UMRs. All 
fields of the mapping register assignment block are 
initialized and the block is linked into the 
assignment list. 

C = 1 if SASUMR could not assign the UMRs. 


All registers are preserved. 


Entry Points - 


SCEFN:: 
SCEFI:: 


Calls 


Input 


Output 


Note 


Entry Point 
SDVMSG:: 


Calls 


Input 


Output 


Note 


Executive code calls these routines to convert an 
event flag number to an event flag mask word and event 
flag mask address. 


None 


RO = Event flag number to be converted 
R5 = TCB address of the task to which the event flag 
applies 


C = 0 if an event flag number was specified. 
RO = Event flag mask word 
Rl = Event flag mask address 


C = 1 if no event flag number was specified. 
RO = Zero 
Rl = Zero 


Directive status returned: 
'D.RS97' if an incorrect event flag number is specified. 


If the SCEFI routine is called, R3 is preserved; 
otherwise, SCEFN adds two to R3. 


This routine queues a message to the task termination 
notification task. The messages are related to a device 
failure or a checkpoint write failure occurring from the 
loader. 


SALOCB, SEXRGF 


RO = Message number 
R5 = Address off the UCB or TCB to which the message 
applies 


SDVMSG calls SALOCB to allocate a four-word packet = and 
stores the message number (RO) in the second word and the 
UCB or TCB address (R5) in the third word. SDVMSG threads 
the packet in the task termination notification task 
message queue. 


If the task termination notification task (SYSGEN option) 
is not installed, or no storage can be obtained, $SDVMSG 
performs no function and returns to the calling routine. 


Entry Point 
SGTPKT:: 


Calls 


Input 


Output 


Note 
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Device drivers call this routine to degueue the next I/0 
reguest to be processed. If the device controller is 
busy, GTPKT sets the carry bit and returns to the caller. 
If the device controller is not busy, GTPKT tries to 
degueue the next reguest from the controller queue. If 
SGTPKT cannot dequeue a request, it sets the carry bit and 
returns to the caller. If the $GTPKT process’ succeeds, 
SGTPKT sets the controller to busy and clears the carry 
bit before returning to the caller. 


SIOALT, SMPPKT, SEXRQP 


R5 = Address of the UCB of the controller for which SGTPKT 
will get a packet. 


C = 0 if SGTPKT successfully dequeued a packet. Also, 
SGTPKT returns the following contents of R1 through 
R53: 
Rl = Address of the I/O packet 


R2 = Physical unit number 

R3 = Controller index 

R4 = Address of the status control block 
R5 = Address of the unit control block 


Cc = 1 if the controller is busy or no request can be 
dequeued 


The contents of R4 and R5 are changed by this routine. 


Entry Points - 


SBLKCKs:: 
SBLKC1:: 


Input 


Output 


~ RIL 


Entry Point 
SDEUMR:: 


Calls 


I/O device drivers call these routines to check the 
starting and ending logical block numbers of an 1/0 
transfer to a file structured device. If the range of 
blocks is not correct, $BLKCK enters SIODON with a final 
status of 'IE.BLK' and then a return to the calling driver 
occurs at the driver's initiator entry point. If the 
range of blocks is correct, $BLKCK returns to the calling 
driver. 


Rl = Address of the I/O packet 
R5 = Address of the unit control block (UCB) 


If the check fails, $BLKCK enters S$IODON with a final 
status of '‘IE.BLK' and S$IODON returns’ to the calling 
driver at the initiator entry point. 


If the check succeeds, S$BLKCK returns the following 
contents of registers RO through R3 to the calling driver: 
RO = Low part of logical block number 

= Points to I.PRMt+t12 (low part of user logical block 
number) 
R2 = High part of logical block number 
R3 = Address of I/O packet 


This routine deassigns a contiguous block of UMRs. If the 
mapping assignment block is not in the list, no action is 
taken. For the sake of assignment speed, the link word 
points to the UMR address (2nd) word of the assignment 
block. 


None 


Input 
Output 
Note 


Entry Point 
$DQUMR: : 


Input 


Output 


MODULE DESCRIPTIONS 


R2 = Pointer to assignment block 
None 


RO and R1 are preserved. 


Control is transfered here to see if a driver is waiting 
for UMR assignemnt. SDQUMR calls the calling driver back 
as a co-routine. When the calling driver issues a_ return 
back to this routine, S$DQUMR checks to see if any drivers 
are waiting for UMRs. If so, $DQUMR restores the waiting 
driver's context without actually de-queveing the mapping 
assignment block and passes control back to the original 
UMR assignment routine. 


(SP) = Return address to the driver's caller 


None 


Entry Points - 


SIODON:: 
SIOALT:: 


Calls 


Input 


Output 


Entry Point 
SIOFIN:: 


Calls 


Input 


I/O device drivers call this routine at the end of an I/0 
request to do final processing. S$IODON sets the unit and 
controller to idle and enters SIOFIN to finish processing. 


SQEMB, SDEUMR, SFORKO 


RO = First I/O status word 

Rl = Second I/O status word. If the entry to this routine 
is at SIOALT, SIOALT clears R1 to signify that the 
second status word is zero (0). 

R2 = Starting and final error retry counts if this process 
is the end of I/O on an error logging device 

R5 = Address of the unit control block of the unit being 
completed 

(SP) = Address of the driver's caller (for return) 


The unit and controller are set idle. 


R3 = Address of the current I/O packet 


This routine is called to finish I/O processing in cases 
where the unit and controller are not to be declared idle. 


SSETF, SCHKPT, SNXTSK, SQINSF, $DEPKT 


RO = First I/O status word 
Rl - Second I/O status word 
R3 = Address of the I/O request packet 


Output 


Note 


Entry Point 
SIOKIL:: 


Calls 


Input 


Output 


Note 


Entry Point 
SLCKPR: : 


Calls 


MODULE DESCRIPTIONS 


SIOFIN: 

1. Stores the final I/O status values in the I/O status 

block if one was specified 

2. Decrements the I/O count and clears TS.RDN in case the 

task was blocked for I/O rundown. 

3. Clears TS.CKR if it is set and initiates checkpointing 
of the task. 

4. Queues an AST for the task if an AST service routine 
was specified. Otherwise, S$IOFIN deallocates the I/0 
packet. 

5. Sets the event flag. 


SIOFIN destroys the contents of R4. 


This routine flushes all I/O requests for the current task 
from a device queue and cancels the I/0 operation in 
progress for the current task. 


SIOFIN, @D.VCAN(R2) - where R2 is the address of the 
driver dispatch table 


R5 = Address of the device UCB of the device for which to 
flush requests 


SIOKIL calls the driver at the cancel I/O operation entry 
point with the arguments: 
RO = Address of the current I/O packet 


Rl = Address of the TCB of the current task 
R3 = Controller index 

R4 = Address of the status control block 

R5 = Address of the unit control block 


SIOKIL destroys the contents of R4. 


This is the lock/unlock processing routine. This routine 
first determines if a file I/O reguest is to a shared 
file. If it is, S$LCKPR determines if the request is an 
UNLOCK QIO or a virtual block I/O request. It then either 
performs the unlock QIO or the lock processing, 
respectively. 


$ALOCB 


Input 


Output 


Note 


Entry Point 
SMPLNE:: 
SMPLUN:: 


Input 


Output 


MODULE DESCRIPTIONS 


The inputs for the main entry point, S$LCKPR, are: 
Rl = I/O packet address of the reguest 


Unlock processing: The section of $LCKPR that performs 
the unlock processing contains the following relevant 
register contents: 

RO = Unlock error status 


Rl = I/O packet address 

R2 = Address of the first lock block in the lock list 
R3 = Pointer to current window 

R4 = Byte count. of current unlock request 


Lock processing: The section of SLCKPR that performs the 
lock processing checks for attempted lock overlaps, tries 
to set the new lock, and performs the implied unlock. If 
a new lock reguest for an explicit unlocker is detected 
that exactly matches an existing lock for that window in 
both starting VBN and size, the lock block is reused. The 
relevant registers contents for this part of S$LCKPR are: 
Rl = I/O packet address 

R2 = Address of first lock block in lock list 

R3 = Address of file window 

R4 = Block count for current request 


SLCKPR contains an internal routine to check for exact VBN 
and block count match. The inputs to this routine are: 

Rl = I/O packet address 

R2 = Lock block address 

R4 = Byte count 


The outputs of this routine are: 
Z = 1 if there is an exact match 
z= 0 if there is no match 

All registers are preserved. 


The outputs of SLCKPR are: 
C = 0 if no lock processing was required 


C = 1 if an unlock was performed or an error condition 
occured during the lock processing. 
RO = I/O status 


Rl is preserved. 


These routines validate a logical unit number (LUN) and 
Map the LUN into a UCB pointer. If the calling routine 
specified an incorrect LUN, $MPLNE returns a directive 
Status of 'D.RS96'. If the LUN is correct, S$MPLNE maps it 
and returns the pointer, which points to the LUN and the 
UCB, to the calling routine. 


R3 = Address of the LUN 
R4 = Address of the header of the current task 
R5 = Address of the TCB of the current task 


Rl contains the address of the second LUN word in the task 
header. 


R3 is advanced by two (2). 


C = 0 if a device is assigned to the specified LUN. 
RO = Address of the UCB of the assigned device 


C = 1 if no device is assigned to a specified LUN. RO 
contains zero (0). 
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Entry Point 
SMPPHY :: 


Calls 


Input 


Output 


Note 


Entry Point 
SMPPKT: : 


Calls 
Input 


Output 


Note 


Entry Point 
$MPUBM: : 


Calls 


MODULE DESCRIPTIONS 


This routine maps a relocation bias and displacement 
address to an 18-bit physical address. If the indicated 
device is not a non-processor request (NPR) device, $MPPHY 
returns the relocation bias and displacement address to 
the caller. Otherwise, S$MPPHY converts the _ relocation 
bias and displacement address to an 18-bit physical 
address and returns this address to the calling routine. 


None 


R1 = Relocation bias 
R2 = Displacement address 
R5 = Address of the unit control block 


If the device is an NPR device: 
Rl = High order 2 bits of physical address in bits 4 and 5 
R2 = Low order 16 bits of physical address 


If the device is an NPR device on an 11/70: 
Rl = High order 6 bits of physical address in high byte 
R2 = Low order 16 bits of physical address 


If the device is not an NPR device: 
Rl = Relocation bias 
R2 = Displacement address 


RO and R3 are preserved across the call. 


This routine maps a read or write virtual function in an 
I/O packet to a read or write logical function. If the 
current window does not map the virtual function, MPPKT 
sets the C-bit and returns the partial mappping results to 
the calling routine. If the window completely maps the 
virtual function, S$MPPKT stores the logical block number 
in the I/O packet and converts the read or write virtual 
function to its logical counterpart. 


SMPVBN, SMPPHY 
Rl = Address of the I/O packet 


C = 0 if mapping was successful. 

RO = Zero (0) 

I.FCN+1(R1) = IO.WLB or IO.RLB 
I.PRM+10(R1) = High part of mapped LBN 
I.PRM+12(R1) = Low part of mapped LBN 


C = 1 if mapping failed. 

RO = Number of blocks not mapped 
R2 = High part of mapped LBN 

R3 = Low part of mapped LBN 


Rl is preserved across call 


UNIBUS NPR device drivers call this routine to load the 
necessary UNIBUS map registers to enable a transfer to 
main memory on an 11/70 processor with extended memory. 


None 


Input 
Output 
Note 


Entry Point 
SMPVBN: : 


Calls 


Input 


Output 


Entry Point 
$RELOC:: 


Calls 
Input 


Output 


Note 


Entry Point 
$RELOM: : 


Calls 
Input 


Output 


Note 
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R4 = Address of device SCB 
R5 = Address of device UCB 


SMPUBM loads the necessary UNIBUS map registers to enable 
a transfer. 


Register R3 is )jpreserved across the call. 


This routine Maps a virtual block number (VBN) to a 
logical block number (LBN) by using a window block that 
contains a set of mapping pointers. 


= The number of consecutive bytes that must be mapped 
= Address of the window block 
R2 = High part of VBN 
= Low part of VBN 
C = 0 if SMPVBN successfully maps the VBN to the LBN. 
Also: 
RO = The number of unmapped blocks 
R2 = High part of LBN 
R3 = Low part of LBN 


C = 1 if SMPVBN could not map the VBN by using the window 
block 


This routine relocates a user's virtual address. SRELOC 
transforms a 16-bit user virtual address into a relocation 
bias and displacement-in-block relative to APR6. 

None 

RO = User's virtual address to be relocated 


Rl = Relocation bias to be loaded into PAR6 
R2 = Displacement-in-block plus 140000 (PAR6 bias) 


RO and R3 are preserved across the call. 


This routine transforms a 16-bit user virtual address into 
a relocation bias and displacement-in-block relative to 
APR6 and loads these values for access by the caller. 
$RELOC 

RO = User's virtual address to be relocated 

RO = Displacement-in-block 


SRELOM loads KISAR6 with the relocation bias 


R3 is preserved across the call. 


Entry Point 
SRLCH: : 


Calis 
Input 


Output 


Note 


Entry Point 
SRQCH: : 


Calls 


Input 


Output 


Entry Point 
SSCDVT:: 
SSCDV1:: 
Calls 

Input 


Output 


MODULE DESCRIPTIONS 


This routine releases. a channel. It sets the channel 
Status to idle and tries to dequeue the next driver 
waiting to use the channel. If no driver is waiting, 
SRLCH returns to the calling routine. Otherwise, $RLCH 
degqueues the driver, sets the channel status to busy, 
calls the driver, and returns to the calling routine. 


SQRMVF 
R5 = Address of the unit control block 


SRLCH sets the channel status to idle and tries to dequeue 
the next driver waiting to use the channel. 


RO, Rl, and R2 are preserved across the call. 


$RLCH destroys the contents of R4. 


This routine requests exclusive use of a channel. If the 
channel is busy, $RQCH threads the calling driver into the 
channel wait gueuve and returns to the routine that called 
the driver. If the channel is not busy, $RQCH sets the 
channel status to busy and returns to the calling driver. 


SQINSF 


R4 = Address of status control block 

R5 = Address of unit control block 

(SP) = Return address of calling routine 

2(SP) = Return address of the routine that called the 
calling routine. 


The calling driver is threaded into the channel wait 
queue. 


This co-routine scans device tables for a calling routine. 
For each UCB. found, this co-routine calls the calling 
routine and returns the UCB, DCB, and SCB addresses to it. 


@(SP)+ (the calling routine) 

R3 = List pointer (if entry is at $SCDV1) 

C = 0 if the next device table entry is being returned 
R3 = Address of the device control block (DCB) 

R4 = Address of the status control block (SCB) 

R5 = Address of the unit control block (UCB) 


C = 1 if no more entries exist in the device tables 


Entry Point 
SSTMAP: : 


Calls 

Input 
Output 
Note 

Entry Point 


SECCOR:: 


Calls 


Input 


Output 


MODULE DESCRIPTIONS 


UNIBUS NPR device drivers call this routine to set up the 
UNIBUS mapping address. S$STMAP first assigns the UNIBUS 
Mapping registers (UMRS). If the UMRS cannot be 
allocated, $STMAP places the driver's mapping assignment 
block in a wait gueue and returns to the driver's caller. 
The assignement block will be degueued eventually when the 
UMRsS are available and the driver will be remapped and 
returned to with R1 through R5 preserved and the normal 
outputs of this routine. SSTMAP stores the driver's 
context in the assignment block and the fork block while 
it is blocked and in the wait gueue. Once SSTMAP places 
the driver's mapping assignment block in the UMR wait 
queue, it is not removed from the gueve until the UMRs are 
successfully assigned. This strategy assures that waiting 
drivers are serviced FIFO and that drivers with large 
reguests for UMRs will not wait indefinitely. 


SASUMR, SWTUMR 


R4 = Address of the device SCB 
R5 = Address of the device UCB 
(SP) = Return to driver's caller 


SSTMAP sets up UNIBUS map addresses in the device UCB and 
moves the actual physical address to the SCB. 


Registers Rl, R2, and R3 are preserved across the call. 


This routine contains common error correction code (ECC) 
for the RPO4 and RK06. S$ECCOR applies the ECC correction 
algorithm and determines if offset recovery is required 
(if supported). 


$SRELOP 


Rl 
R2 
R3 
R5 


Contents of error register 

Control status register (CSR) address 
Address of first ECC register 

UCB address 


R3 = Controller index 


C = 0 if offset recovery is not reguired 

RO = IS.SUC&377 

Rl = bytes actually transfered 

R2, R4, and R5 are unmodified 

U.BUF and U.BUF+2 are updated by a call to SRELOP 


C = 1 if offset recovery is reguired 
RO = Number of good bytes transfered 
Rl - R5 are unmodified 


Entry Point 
SRELOP: : 


Calls 


Input 


Output 


Entry Point 
SCRPAS:: 


Calls 


Input 


Output 

Note 

Entry Point 
SMUL: 

Calls 


Input 


Output 


Note 


Entry Point 
SDIV:: 
Calls 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


This routine relocates a UNIBUS physical address to a 
KISAR6 bias and displacement. 


None 


RO = byte offset from address in U.BUF+1 and U.BUF+2 
R5 = UCB address 

U.BUF+1(R5) = High order bits of physical address 
U.BUF+2(R5) = Low order; bits of physical address 


KISAR6 = Calculated bias (mapped system) 
Rl = Real address or displacement 


This is the common register pass routine. SCRPAS passes 
the contents of the device registers back to the 
diagnostic task. This routine passes all registers in the 
order in which they appear on the UNIBUS. S$CRPAS uses the 
error logging entries, S.ROFF and S.RCNT, in the status 
control block. To use this routine, error logging must be 
enabled. 


= I/O packet address 
R2 = Control status register address 
= Status control block address 


RO and R2 are preserved. 
This is the integer multiply routine. 
None 


RO = Multiplier 
Rl = Multiplicand 


$MUL returns a doubleword result in RO and Rl. The high 
part is in RO and the low part is in Rl. 


Registers R2, R3, R4, and R5 are preserved across the 
call. 


This is the integer divide routine. 


None 


RO = Dividend 
Rl = Divisor 


S$DIV returns the quotient in RO and the remainder ih Rl. 


Registers R2, R3, R4, and R5 are preserved across’ the 
call. 


Entry Point 
SWIUMR: : 


Calls 
Input 


Output 


MODULE DESCRIPTIONS 


This routine waits for a change in the UMR state. Tt 
stores Rl through R4 and the return PC in the mapping 
assignment block and queues the block in the UMR wait 
queue for a subsequent recall to the caller when the state 
of the UMRs changes. It is possible for the mapping 
assignment block to already be in the wait gueuve. If it 
is, it can be at the head of the queue only. 


None 
RO = Pointer to UMR assignment block 
SWTUMR gueues the assignment block in the UMR' wait queue. 


SWTUMR returns to the caller at system state with Rl 
through R4 preserved. 


7.2.34 LOADR Module 


LOADR 


The LOADR module is a task that loads and checkpoints all 
nonresident tasks. 


Macro Library Calls - 


ABODFS$ 
HDRDFS 
HWDDFS 
PCBDFS$ 
TCBDFS 


Entry Point 
SLOADR:: 


Calls 


Define task abort codes 

Define task header offsets 

Define hardware registers 

Define partition control block offsets 
Define task control block offsets 


This task: 

@ Reads a nonresident task into memory and initializes it 
for execution. 

@e Reads a previously checkpointed task back into memory 
and restarts its execution. 

@ Writes a checkpoint image of a running task and frees 
its partition. 


SLOADR gets its input from a loader gueue by a call to 
SQRMVF. The loader gueue contains a priority ordered list 
of task TCBs. $LOADR removes the highest priority (the 
first) TCB from the queue and processes it. $LOADR 
processes the TCBs in the gueuve in priority sequence. 


SQRMVF, SSTPCT, SDEACB, SQINSP, S$RLPAR, SDVMSG, S$ALOCB, 
STKWSE, SMAPTK, SCRATT, SSWSTK, SBILDS, $CHKPT, S$DASTT, 
SACTTK, SABTSK 


7.2.35 LOWCR Module 


LOWCR 


The LOWCR module contains low core pointers, trap and 
interrupt vectors, and the Executive stack area. This 
module contains one executable statement - a JUMP to the 
panic dump routine ($PANIC). The other statements define 
the addresses of trap processing modules and low core 
pointers. 
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Calls 
Input 


Output 


MODULE DESCRIPTIONS 


This file must be the first in the task builder command 
file because it occupies locations starting at real 
location zero. 


The following low core pointers are contained in this 
module: : 

Address of directive status 

Directive status word 

FCS impure area pointer 

FORTRAN impure area pointer 

Overlay run time system impure area pointer 


The system stack area contains a minimum of 40. words. 
None 
None 


None 


7.2.36 PARTY Module 


PARTY 


Execution of this module occurs because of a memory parity 
error interrupt. Any error that occurs on the system 
stack or in the Executive is a fatal error. A fatal error 
halts the system and the message "***EXEC PARITY ERROR***" 
is printed. Otherwise, the task occupying the memory in 
which the error occurred is aborted and locked into memory 
to prevent that portion of memory from being used again. 
A message is printed to indicate that the task was 
aborted. 


Macro Library Calls - 


ABODFS 
HWDDFS$ 
PCBDFS 
TCBDFS$ 


Entry Point 
PARER?: 
Calis 
Input 


Output 


Define task abort codes 

Define hardware registers 

Define partition control block offsets 
Define task control block offsets 


Memory parity error interrupt processing module 
SALEMB, S$QEMB, SABTSK. 
None 


None 


MODULE DESCRIPTIONS 


Note The error message block (EMB) format (for error logging) 
for cache parity is: 
WD. 00 - Link word 


WD. 01 - Size = 37.*2 
WD. 02 - Processor type/entry code = 002 
WD. 03 - Minute/second 

“WD. 04 - Day/hour 

WD. 05 - Year/month 

WD. 06 - Error sequence number 

WD. 07 - Trap PC 

WD. 08 - Trap PS 

WD. 09 - First word of task name 

WD. 10 - Second word of task name 

WD. ll - First word of partition name 
WD. 12 - Second word of partition name 
WD. 13 - Partition base address 

WD. 14 = Partition size 


WD. 15 to WD. 30 - Memory parity control status registers 
(CSRs) 
WD. 31 to WD. 36 - Cache parity CSRs 


7.2.37 PLSUB Module 


PLSUB The PLSUB module contains the following program logical 
address space subroutines: 
SSRNAM Search for a named partition 
SCKACC Check desired access 
SCRATT Create attachment descriptor 
SSRATT Search for attachment descriptor 
SSRWND Search for specified address window 
SUNMAP Unmap address window 

Macro Library Calls - 

HDRDFS Define task header offsets 

HWDDFS Define hardware registers 

PCBDF$ Define partition control block offsets 

TCBDFS Define task control block offsets 


Entry Point - 

SSRNAM:: This routine searches for a named partition and returns a 
success or failure indication and a pointer to the PCB if 
it finds the partition. 


Calls None 
Input R3 = Pointer to the double-word RAD50 name 
Output C = 0 if SRNAM finds the named partition. 


R2 = The PCB address 


C = 1 if SRNAM does not find the name 


Entry Point 
$SCKACC:: 


Calls 


Input 


Output 


Entry Point 
SCRATT:: 


Calls 


Input 


Output 


Entry Point 
SSRATT: : 


Calls 


Input 


Output 


MODULE DESCRIPTIONS 


This routine checks if the desired access of a task to a 
region is allowed. The bits in the protection word are 
arranged in the following order: 


WORLD ,GROUP ,OWNER , SYSTEM 
a5 0 


The bits within each category in the protection word are 
arranged in the follwing order: 


DELETE EXTEND WRITE READ 
3 2 1 0 


If a bit is set, the corresponding access is not allowed. 
None 


RO = Desired access mask in the low four bits 
Rl = Current UIC of the task 
R2 = PCB address of the region 


CKACC changes the contents of RO and Rl. 


CKACC returns a directive status of 'D.RS16' to the 
calling routine if access to the region is not possible. 


_ 


This routine creates an attachment descriptor block and 
inserts it in the necessary queues. 


$ALOCB, SQINSF, SQINSP 


R2 = PCB address of the region being attached to 
R4 = Access code 
R5 = TCB address of attaching task 


C = 0 if CRATT successfully completes execution. 
Rl = Address of the attachment descriptor block 
CRATT changes the contents of RO 


C = 1 if an attachment descriptor could not be allocated. 
CRATT modifies RO and Rl. 


This routine verifies that a valid region ID was passed in 
a PLAS directive by searching for the corresponding 
attachment descriptor in the task control block's 
attachment gueue. 


None 

R3 = Address of the region ID to be verified (or 0 for 
task region) 
R5 = TCB address of the current task 

R5 = Address of the attachment descriptor 


SRATT returns a directive status of D.RS86 if the 
attachment descriptor cannot be found. 


Entry Point 
SSRWND:: 


Calls 


Input 


Output 


Entry Point 
SUNMAP: : 


Calls 
Input 


Output 


MODULE DESCRIPTIONS 


This routine verifies that the specified address window ID 
corresponds to a valid established address window. 


None 


R3 = Address of the address window ID 
R4 = Address of the current task header 


R4 = Pointer to the specified window block 
SRWND chages the contents of RO 


SRWND returns a directive status of D.RS87 if the 
specified address window is invalid. 


This routine searches for and conditionally unmaps' the 
specified address window. 


None 
R4 = Address of the window to be unmapped 
UNMAP modifies RO 


C = 1 if UNMAP sucessfully unmapped the address window 


7.2.38 POWER Module 


POWER 


This is the powerfail recovery module. If power fails, the 
POWER module saves the stack pointer, hardware registers 
RO - R5, UNIBUS mapping registers, memory management 
registers, floating point status, mode, and registers, and 
the program interrupt reguest. 


When power comes back on, POWER restores all the 
registers, forces a schedule request for the null task, 
increments the powerfail indicator, and executes an RTI 
instruction. 


The dispatcher then calls the S$POWER routine in this 
module to restart the system. 


The POWER module contains the following labels and 
routines: 


PWBTM: This is the label of register storage area 

PWSTK: This is the label of the stack pointer storage 
area 

PWVCT: Defines the powerfail vector 

PDOWN: This routine is entered when a power failure 
interrupt occurs. This routine saves all volatile 
machine registers, switches the power fail vector 
to the power up routine (PUP:), and halts the 
processor to await the power up interruption. 


MODULE DESCRIPTIONS 


PUP: This routine is entered when a power up interrupt 
occurs. It restores all volatile machine 
registers, forces a schedule request for the NULL 
task, increments the powerfail indicator, and 
executes an RTI instruction. The dispatcher then 
calls the power recovery routine ($POWER::), which 
is in this module, to re-~instate system 
processing. 

SPOWER:: Restart system processing 


Macro Library Calls - 


EMBDFS 
HDRDFS 
HWDDFS$ 
PCBDFS$ 
TCBDFS 


Entry Point 
SPOWER: : 


Calls 


Input 


Output 


Define error message block offsets 
Define task header offsets 

Define hardware registers 

Define partition control block offsets 
Define task control block offsets 


The dispatcher calls the POWER routine after the PUP 
routine restores the volatile registers. The POWER routine 
clears the power failure indicator and declares a 
significant event. If the KW11-Y is supported, POWER 
clears the clock error flags and energizes the output 
relay. POWER then enables parity error interrupts, clears 
the 11/70 parity control register, clears the memory error 
register, declares power failure ASTs for task that are 
active and in core, and performs a power failure recovery 
for all active devices. 


SDRDSE, SALEMB, SQEMB, SDASTT, @D.VPWF(R2)-where R2 is the 
address of the device dispatch table 


SPOWER calls the driver at the powerfail entry point with 
the following arguments: 

R3 = Controller index 

R4 = Address of the status control block 

R5 = Address of the unit control block 


None 


7.2.39 QUEUE Module 


QUEUE 


The QUEUE module contains the following gueve manipulation 
routines: 


SCLINS:: Clock queue insertion 
SCLRMV:: Clock queue removal 
SQINSF:: Queue insertion at end of list 

_ $QINSP:: Queue insertion by priority 
SQMCRL:: Queue MCR command line 
SQRMVF:: Queue removal from front of list 
SQRMVT: : Queue removal by TCB address 


Macro Library Calls - 


CLKDFS$ 
TCBDFS 


Define clock gueue control block offsets 
Define task control block offsets 


Entry Point 
$CLINS:: 


Calls 


Input 


Output 


Entry Point 
SCLRMV:: 


Calls 


Input 


Output 


Entry Point 
SQINSF:: 


Calls 


Input 


Output 


Entry Point 
SQINSP:: 


Calls 


Input 


Output 


MODULE DESCRIPTIONS 


This routine makes an entry in the clock gueue. The 
routine inserts the entry in a way that allows the clock 
gueue to be ordered in ascending time sequence. Thus, the 
entries at the top (or front) of the queue are the most 
immminent. 


= Address of the clock gueue entry core block 
= High order half of delta time 
R2 = Low order half of delta time 
= Request type 
= Address of requesting TCB or reguest identifier 


The clock queue entry is inserted in the clock gueue 
according to the time that it will become due. 


This routine removes all entries for a specified TCB 
address and request type from the clock queue. 


$DECLK 


R4 = Request type 
R5 = Address of requesting TCB or system subroutine 


CLRMV removes all entries for the specified TCB address 
and request type from the clock gueuve. If the request type 
is not 'C.SYST', CLRMV releases the clock queue entry core 
block. 


This routine makes an entry in a first-in first-out list. 
It links the entry to the end of the list. This routine 
shares common code with the SQINSP routine. 

None 


RO = Address of the two-word listhead 
Rl = Address of the entry to be inserted 


The entry is linked to the end of the gueue. 
RO and Rl are preserved across the call. 


This routine inserts an entry in a priority ordered list. 
QINSP searches the list until it finds an entry that has a 
lower priority or it finds the end of the list. The new 
entry is linked into the list at whichever of these two 
points is appropriate. 


None 


RO = Address of the two-word listhead 
Rl = Address of the entry to be inserted 


QINSP links the entry into the list in priority order. 


RO and Rl are preserved across the call. 


Entry Point - 
SQMCRL: 3 


Calls 
Input 


Output 


Entry Point 
SQRMVF: : 


Calls 
Input 


Output 


Entry Point 
SQRMVT:: 


Calls 


“Input 


Output 


7.2.40 


REQSB 


MODULE DESCRIPTIONS 


This routine gueves a command line for MCR. 
SEXROF 
Rl = Address of the command line control block 


Via the call to EXRQF, the command line is inserted into 
the MCR command line list and MCR is reguested to run. 


This routine removes the next (front) entry from a list. 
The list organization may be either FIFO or by priority. 


None 
RO = Address of the two-word listhead 


C = 0 if QRMVF removes the next entry from the list Rl #* 
Address of the entry removed 


C = 1 if there are no entries in the list RO is preserved 
across the call 


This routine removes the next entry from a list that 
matches a specified TCB address. The list organization may 
be either in FIFO or in priority order. | 

None 


RO = Address of the two-word listhead 
Rl = Address of the TCB for which QRMVT searches 


C = 0 if QRMVT removes a matching entry from the list 
Rl = Address of the entry removed 


C = 1 if there is no entry in the list that matches’ the 
TCB address 


RO is preserved across the call 


REQSB Module 


This module contains the following task control routines: 


SABCTK Abort current task 
_ SABTSK Abort task 

SBILDS Build stack and initialize header 

SACTTK Put task in active task list 

SSETCR Set conditional schedule request 

SSETRQ Set schedule reguest 

SSETRT Set schedule request for current task 

SSETF Set event flag 

SSETM Set event flag 

SDASTT Declare AST trap 

SDQAC Degueue AST block queued by SQASTC (called 
from SYSXT only) 

SQASTC Queue AST to task 

SQASTT Queue AST to task 

$SRSTD Search system task direetory 


MODULE DESCRIPTIONS 


SACTRM Remove task from the active task list 

SSTPCT Stop current task 

SSTPTK Stop task 

SRLPAR Release task partition 

SRLPR1 Release partition 

SNXTSK Assign next task to partition 

SFNDSP Find space in partition control block (PCB) 
list 

STSTCP - Test if checkpoint should be initiated 

SICHKP Initiate checkpoint 

SCHKPT Checkpoint task 

SLOADT Put task in loader queue 

SEXRQP Executive request with queue insert by 
priority 

SEXROF Executive request with gueuve insert FIFO 

SEXROQN Executive request with no gueuve insertion 

STSKRT Task execution request (default UCB) 

STSKRQ Task execution request (UCB specified) 

$TSKRP Task execution request (default UIC specified) 

SUISET Establish default UIC and current UIC 

SMAPTK Map task address window 


Macro Library Calls - 


HDRDFS 
ITBDFS 
PCBDFS 
TCBDFS 


Entry Point 
SABCTK:: 
SABTSK:: 


Calls 


Input 


Output 


Entry Point 
SBILDS:: 


Calls 


Input 


Define task header offsets 

Define interrupt transfer block offsets 
Define partition control block offsets 
Define task control block offsets 


Abort current task 

Abort task 

These routines mark a task to be aborted and they force a 
task's exit. They store the abort reason and the current 
outstanding I/O count in the first task event flag word. 
If the entry occurs at SABTSK, Rl contains the address of 
the TCB of the task to be aborted. If the entry occurs at 
SABCTK, the TCB address of the task to be aborted is moved 
into Rl. Otherwise, the remainder of the two routines have 
common code. 


SSETCR, SNXTSK 


RO = Reason for the abort 
Rl = Address of the TCB of the task to be aborted when 
entry occurs at SABTSK only. 


These routines mark the task to be aborted and set a 
conditional schedule reguest. 


This routine sets up the task stack and initializes the 
header. This routine is called prior to placing a task 
into contention for the processor. This occurs when an 
execution reguest is made for a task that is fixed in 
memory or when a disk resident task has finished loading. 


None 


RO = Address of the TCB of the task to initialize 


Output 


Entry Point 
SACTTK:: 


Calls 


Input 
Output 
Entry Point 
SSETCR 


SSETRQ 
SSETRT 


Calls 


Input 


Output 


Entry Point 
SSETF $SETM 


Calls 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


SBILDS:: 

1 - Clears the task local event flags 1. through 32. 

2 - Sets up the current UIC in the header 

3 - Sets up task context (PC, PS, stack pointer) to cause 
the task to start execution at its entry 

4 Conditionally requests redispatching of the processor 


This routine puts an active task in the active task list. 
None 


RO = Address of the TCB of the task to be put in the 
active task list. 


ACTTK merges the specified task into the active task list 
by priority. 


R3 is preserved across the call. 


Set conditional schedule request 

Set schedule reguest 

Set schedule request for current task 

These routines force redispatching of the processor from a 
specified position in the active task list. If a previous 
request was set, redispatching starts at whichever reguest 
has the highest priority. 


These routines share common code. 
SDRDSE 


If entry occurs at $SETRT: 
R5 = Address of the TCB of the current task 


If entry occurs at $SETRQ or $SETCR: 
RO = Address of the TCB at which dispatching is to start 


These routines set a schedule request that forces a 
redispatching of the processor when a system exit is 
executed. 

R2 and R3 are preserved across the call. 

RO is preserved across the call if entry occurs at SSETRQ 
or $SETCR. 


These routines set an event flag and do the required 
rescheduling. 


CEFI, $DRDSE 

RO = Event flag number (SSETF) or agent flag mask (S$SETM) 
R1 = Buen flag word address ($SETM only) set 

R5 = TCB address for which flag is being set 

RO = TCB address of the task whose flag was set 


R3 is preserved 


Entry Point 
SDASTT:: 


Calls 


Input 


Output 


Note 


Entry Point 
$DQAC 


Calls 
Input 
Output 


Entry Point 
SQASTC 


Calls 
Input 


Output 


Note 


Entry Point 
SQASTT: ; 


Calls 


Input 


MODULE DESCRIPTIONS 


This routine declares a non-I/O related ast trap. It 
examines the header of the specified task to determine if 
the specified AST is enabled. If it is enabled, the AST is 
declared. 


None 


R4 = Offset into the task header to the AST control block 
address 

R5 = Address of the TCB of the task for which the AST is 
to be declared 


C = 0 if DASTT succeeded in setting up the task for the 
AST and declaring the AST 

Rl = Address of the AST control block 

C = 1 if the task is not setup for the specified AST 


DASTT alters the contents of R4 during execution 


This routine degueuves an AST block that was queued by 
SQASTC 


None 
RO = Pointer to AST block 


A.CBL is set to one (1) to indicate that the AST block is 
free (not in AST queue) 


Queues an AST to a task. This routine is a variant of 
SQASTT used by a task ISR which was specified in a CINTS 
directive. 


None 
R5 = Pointer to fork block in ITB 
C = 0 if the AST is queued. 


C = 1 if the AST address was not specified in the CINTS$ 
call. 


If the AST block is already gqgueuved for the task, $QASTC 
takes no action and returns C = 0. 


SQASTC alters RO, Rl, R2, and R3. 


This routine gueues an AST to a task and ensures that’ the 
task will be scheduled and reconsidered for eligibility in 
the partition. 


SQINSF, SSETCR, S$NXTSK 


RO 
Rl 


TCB address of the task to receive the AST 
Address of the AST control block to be used 


Output 


Entry Point 
SSRSTD:: 
Calls 

Input 


Output 


Entry Point 
SACTRM: : 
Calls 

Input 


Output 


Entry Point 
SSTPCT:: 
SSTPTK:: 


Calls 


Input 


Output 
Entry Point 


SRLPAR:: 
SRLPR1:: 


Calls 


MODULE DESCRIPTIONS 


C = 0 if QASTT successfully completed execution 


Rl is preserved across the call 


This routine searches the task directory for a task of the 
specified name. 


None 
R3 = Address of the task name for which to search 


C = 0 if SRSTD finds the task. 
RO = Address of the TCB 


C = 1 if SRSTD did not find the specified task 


R1, R2, and R3 are preserved across the call 


This routine removes a task (its TCB) from the active task 
list. 


None 
RO = Address of the TCB to be removed 


C = 0 if ACTRM succeeds in removing a matching entry from 
the list 


C = 1 if there is no entry in the list that matches’ the 
TCB address 


RO is preserved across the call 


Stop the current task 

Stop the task 

These routines stop a task and reallocate the task's 
partition. 


SSETCR 


RO = The TCB of the task to be stopped (if entry occurs at 
SSTPTK) 


None 


Release task partition 

Release partition 

This routine releases a partition owned by a task and 
assigns the partition to the next highest priority task 
waiting to occupy the partition. 


None 


Input 


Output 


Entry Point 
SNXTSKs: 


Calls 
Input 


Output 


Entry Point 
SFNDSP:: 


Calls 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


RO = Address of the TCB of the owner task (if entry occurs 
at SRLPAR) 

Rl = Address of subpartition PCB to release (if entry 
occurs at $RLPR1) 

R3 = Address of main partition PCB (if entry occurs at 
$RLPR1) 


The partition is released and assigned to the next highest 
priority task waiting to occupy the partition. 


This routine assigns a partition to the highest priority 
task waiting to occupy the partition. 


SQRMVT, SLOADT, S$TSTCP, SICHKP, SFNDSP 
RO = Address of the PCB of the partition to be assigned 


Five outputs are possible: 

1 - The partition is not currently busy and a task is 
waiting to occupy the partition. NXTSK assigns the 
partition to the waiting task and places a reguest in 
the loader gueue to load the task. 

2 - The partition is currently occupied by a task that is 
either of higher priority than all waiting tasks or is 
not checkpointable. In this case, the partition cannot 
be assigned to another task. 

3 - The partition is currently occupied by a lower 
priority checkpointable task. NXTSK places a reguest 
in the loader gueue to checkpoint the owner task. 

4 - The highest priority task waiting to occupy the 
partition reguires the main partition while the main 
partition is occupied by one or more tasks that are 
either of higher priority or are not checkpointable. 
In this case the partition cannot be assigned. 

5 - The highest priority task that is waiting to occupy 
the partition requires the main partition. One or more 
tasks of lower priority that are checkpointable 
currently occupy the main partition. NXTSK places a 
reguest in the loader gueue to checkpoint each task. 


This routine finds space within a dynamically allocated 
PCB list. The list represents the allocation state of a 
system controlled partition or dynamic checkpoint file. 


None 

R4 = Address of the PCB for which to find space 

R5 = Address of the main PCB in the list where space is to 
be found 


C = 0 if FNDSP successfully allocated space and linked the 
sub-PCB into the allocation list. 


C = 1 if FNDSP was unsuccessful 


FNDSP changes the contents of RO, Rl, and R2. 


Entry Point 
STSTCP:: 
Calis 


Input 


Output 


Entry Point 
SICHKP:: 
Calls 

Input 
Output 
Entry Point 
SCHKPT: : 
Calls 

Input 
Output 


Entry Point 
SLOADT: : 


Calls 
Input 
Output 


Note 


Entry Point 
SEXRQP:: 
SEXROF:: 
SEXRON:: 


Calls 


MODULE DESCRIPTIONS 


This routine checks the priority of the requested task to 
determine if the owner task should be checkpointed. 


None 


Rl = Address of the TCB of the owner task 
R4 = Address of the TCB of the requested task 


C = 0 if checkpoint should occur 


C = 1 if checkpoint should not occur 


This routine starts the process of checkpointing a _ task. 
The SCHKPT routine does the actual checkpointing. 


SSETCR 
Rl = Address of the TCB of the task to be checkpointed 


None 


This routine checkpoints a task. 
SALOCB, $DEACB, $FNDSP 
Rl = Address of the TCB of the task to be checkpointed. 


SCHKPT: 

1 - Sets the checkpoint flag in the task status word 
2 - Places the task in the loader gueue 

3 = Reguests the loader to checkpoint the task 


This routine puts a task in the loader gueue for an 
initial load or a checkpoint operation. This routine 
contains one instruction only, which moves the address of 
the TCB of the loader into RO. 


None 
Rl = Address of the task control block 
None 


This routine shares code with the S$EXRQP, SEXROQF, and 
SEXRON routines. 


Executive request with gueue insert by priority 

Executive request with gueuve insert FIFO 

Executive reguest with no queve insertion 

The Executive uses these routines when reguesting all 
tasks. 


SSETCR 


Input 


Output 


Entry Point 
STSKRT: : 
STSKRQ:: 
STSKRP:: 


Calls 


Input 


Output 


Note 

Entry Point 
SUISET:: 
Calls 


Input 


Output 


Entry Point 
SMAPTK: : 


Calls 


Input 


Output 


Note 


MODULE DESCRIPTIONS 


RO = TCB address of the task to be requested 
Rl = Address of the packet to be gueued to the task (if 
entry occurs at SEXRQP or SEXRQF) 


C = 0 if the request successfully completed execution. 
C = 1 if the task was not reguested and, 
zZ = 0 if the PCB could not be allocated 
Z = 1 if the task is active, being removed, or being 


fixed 


Task reguest (default UCB) 

Task request (specify UCB) 

Task reguest (specify default UIC) 

These routines request the execution of a task. 


SALOCB, S$QINSP, SNXTSK, S$BILDS 


RO = Address of the TCB of the task to be requested 
R1 = Reguest UIC 

R2 = UCB address if entry at $TSKRQ 

R3 = Default UIC if entry at STSKRP 


C = 0 if these routines successfully request the execution 
of the task 


C = 1 if the task was not requested 
Z = 1 if the task is active or is being fixed in memory 
zZ = 0 if the PCB could not be allocated 


These routines share common code. 


This routine establishes the default and current UIC for 
requested tasks in multi-user systems. 


None 

Rl = Request UIC 

R2 = Address of second status word of the current task 
R4 = Address of the header of the current task 

C = 0 if UISET establishes the UIC 


Rl = Current UIC 
R3 = Default UIC 


C = 1 if a nonprivileged task is trying to change the UIC 


This routine maps the first window block in a task's 
header in a mapped system from the task's TCB and PCB. 


None 

Rl = Pointer to the number of window blocks in the task 
header 

R5 = Address of the task control block (TCB) for the task 


Rl 


Address of the last PDR image in the task header 


MAPTK modifies the contents of R2. 


MODULE DESCRIPTIONS 


7.2.41 SSTSR Module 


SSTSR 


The SSTSR module contains the following synchronous system 
trap service routines: 
SEMSST:: Non-RSX EMT/TRAP instruction processing 


SFLTRP:: Floating-point exception processing (11/40) 

SFLTRP:: Floating-point exception processing (11/45) 

SFPINT:: Programmed interrupt request entry point 

SILINS:: - Illegal or reserved instruction processing 

SIOTRP:: IoT instruetion processing 

SSGFLT:: Segment fault processing 

STRACE: : Trace (T-bit) or break point instruction (BPT) 
trap processing 

STRPO4:: Trap at 4 (odd address, non-existent memory, 
etc.) processing 

SSSTXT:: Common SST exit routine 


The SSTSR module contains the following local data: 
1 - Floating point exception vector - 

»WORD SFLTRP 

»WORD PR7 

-WORD $FPINT 

~WORD PR7 


2 - Floating point status and fork block 
FLSTS: .BLKW 2 
FLFRK: .BLKW 2 


3 - Segment fault vector - 
-WORD SSGFLT 
»WORD PR7 


Macro Library Calls - 


ABODFS 
HDRDFS$ 
HWDDF$ 
PKTDFS 


Entry Point 
SEMSST:: 


Calls 
Input 


Output 


Entry Point 
SFLTRP:: 


Calls 


Define task abort codes 
Define task header offsets 
Define harware registers 
Define I/O packet offsets 


The directive dispatcher (DRDSP) transfers control to this 
routine when the system executes a non-RSX EMT or TRAP 
instruction. The machine state was saved before entry into 
this routine occurs. EMSST sets up the EMT/TRAP code (low 
byte of the instruction) to be passed to the user and 
transfers control to the SST exit routine. 


None 
R5'= Address of the EMT/TRAP instruction 


04(SP) = EMT/TRAP code multiplied by 2 

02(SP) = SST code (SCEMT=EMT, SCTRP=TRAP) 

OO(SP) = Number of bytes to be transfered to the user 
stack (6) 


The system traps to this routine when an 11/40 floating 
point exception occurs. FLTRP saves the current machine 
state and transfers control to the SST exit routine. 


None 


Input 
Output 
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None 


02(SP) = SST code (SCFLT) 
00(SP) = number of bytes to be transfered to user stack 
(4) 


Entry Points - 


SFLTRP:: 
SFPINT:: 


Calls 


Input 
Output 


Entry Point 
SILINS:: 


Calls 
Input 


Output 


Note 


Entry Point 
SIOTRP:: 


Calls 
Input 


Output 


Note 


The system traps to this entry point when an 11/45 
floating point exception occurs. FLTRP saves the floating 
point excepticn and address registers and posts a 
programmed interrupt request at priority level l. 

Control returns to this entry point when the programmed 
interrupt request, which was issued by FLTRP, is processed 
by the system. 


SINTSV, $FORKO, $DASTT 


The floating point exception register contains the reason 
for the fault and the floating point address register 
contains the address of the instruction that caused the 
fault. 


The outputs are the saved floating point exception and 
address registers and the posted programmed interrupt 
request. 


A trap occurs to this routine when the system tries to 
execute an illegal or reserved instruction. This routine 
saves the current machine state and transfers control to 
the SST exit routine. 


None 
None 


O2(SP) = SST code (SCILI) 
00(SP) = number of bytes to be transferred to the user 
stack (4) 


This routine shares common code with the S$TRPO4 routine. 


The system traps to this routine when it executes an I0T 
instruction. If the stack depth is not +1, this routine 
crashes the system via a jump to S$CRASH. If the stack 
depth is +1, this routine saves the current machine state 
and transfers control to the SST exit routine. 


None 

None 

The following arguments are set up on the current stack: 

Q02(SP) = SST code (SCIOT) 

0O(SP) = Number of bytes to be transfered to the user 
stack (4) 


This routine shares common code with the $TRP04 routine. 


Entry Point 
S$SGFLT:: 


Calls 
Input 


Output 


Entry Point 
STRACE:: 


Calls 
Input 


Output 


Note 


Entry Point 
STRPO4:: 


Calls 
Input 
Output 


Note 


Entry Point 
SSSTXT:: 


Calls 


MODULE DESCRIPTIONS 


The system traps to this routine when a segment fault 
occurs. SGFLT saves the current machine state, sets up SRO 
through SR2 to be passed to the user, and transfers 
control to the SST exit routine. 


None 

None 

10(SP) = Contents of SRO 

06(SP) = Contents of SR2 

04(SP) = Contents of SR1 

02(SP) = SST code (SCSGF) 

00(SP) = Number of bytes to be transfered to the user 


stack (10) 


The system traps to this routine when a trace trap bit 
(T=bit) occurs or when the system executes a breakpoint 
trap instruction. This routine saves the current machine 
state and transfers control to the SST exit routine. 


None 
None 


02(SP) = SST code (SCBPT) 
00(SP) = Number of bytes to be transfered to the user 
stack (4) 


This routine shares common code with the S$TRPO4 routine. 


The system traps to this routine when a trap at 4 occurs. 
If a stack violation occurred (stack pointer=<400), this 
routine crashes the system. Otherwise, this routine saves 
the current system state and transfers control to the sst 
exit routine (SSTXT). 


None 
None 


02(SP) = SST code (SCOAD) 
00(SP) = Number of bytes to be transferred to the user 
stack (4) 


This routine shares common code with the exit routine 
(SSTXT). 


This routine gets control to affect a synchronous’ system 
trap (SST). If the current system stack depth is not zero, 
this routine crashes the system. If the stack depth is 
zero, the routine tries to execute an SST for the current 
task. If the task does not have the appropriate SST vector 
entry or this routine cannot push the SST parameters onto 
the stack, this routine aborts the task. Otherwise, this 
routine sets up the SST and executes a directive exit. 


SACHCK, $RELOM, SABCTK 


Input 


Output 


7.2.42 
SYSCM 
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For a mapped system: 
24(SP) = PS word saved by SST trap 


22(SP) = PC word saved by SST trap 

20(SP) = Saved R5 

16(SP) = Saved R4 

14(SP) = Saved R3 

12(SP) = Saved R2 

10(SP) = Saved Rl 

06(SP) = Saved RO 

04(SP) = SST parameter (zero or more parameters may be 


specified) 

02(SP) = SST ccde 

00(SP) = Number of bytes to be transferred to the the user 
stack 


For a real memory system: 
14(SP) = Saved R3 


12(SP) = Saved R2 

10(SP) = Saved Rl 

06(SP) = Saved RO 

04(SP) = SST parameter (zero or more parameters may be 
specified) 

02(SP) = SST code 

00(SP) = Number of bytes to be transfered to the user 
stack 


The routine executes the specified SST for the current 
task. 


SYSCM Module 


The SYSCM module defines common data areas that are used 
by the system for storage of system data and pointers. The 
module does not. contain executable code; it only defines 
system data areas. The global areas defined in this module 
are shown below. The null task control block areas in 
SYSCM are unique for this TCB. Remaining areas, as noted, 
are in the true system common area 


For the null task control block: (This TCB terminates’ the 
system and active task lists. It must have a priority of 
zero and always be blocked.) 


SHEADR:: T.LNK - Pointer to current task header 

SCURPR:: T.JOC - Current task priority 

SCOMEF:: T.TCB, T.NAM -— Common event flags 

SSYSID:: T.NAM+2, T.RCVL - System identification 

STKNPT: : T.RCVL+2 - Pointer to TKTN TCB 

SSHFPT:: T.ASTL - Pointer to shuffler TCB 

SCKCNT:: T.ASTL+2 - Address of clock count register 

SCKCSR:: T.EFLG - Address of clock control status 
register 

SCKLDC:: T.EFLG+2 - Clock load count 

SSYUIC:: T.UCB - System UIC (54,1 for mapped system, 


50,1 for unmapped system) 


SEXSIZ:: T.STAT - Address of last byte in Executive 
SPWRFL:: T.5T2 - Powerfail recovery request flag 
SSIGFL:: T.ST3 - Task waiting for significant event 
SLOGHD:: T.NRPC - Logical device assignment list 
SMCRCB:: T.LBN+l - MCR command block address 
SLSTLK:: T.LDV - Lock word (TCB address of owner) 
SCRAVL:: T.MXSZ - Active task list listhead 
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(The labels that follow are in the system common area.) 


Pointers: 

SACTHD:: Active task list listhead 
SABTIM:: Absolute time counter 
STKTCB:: Current task TCB 

SRQSCH:: ~° Schedule request TCB address 
SSTKPD:: Stack depth indicator 
SDEVHD:: First device control block 
SMCRPT:: MCR TCB 

SERRPT: : Error logger TCB 

SCFLPT:: First checkpoint file PCB 
SINTCT:: Clock interrupt ticks count 
SFRKHD:: Fork gueue listhead 
SFMASK:: System feature mask 
SPARPT:: Parity address vector table 
SCLKHD:: Clock gueue 

SCOPT: : Command output UCB 

SPARHD:: Partition list 

SLDRPT: : Loader TCB 

STSKHD:: System task directory 


Idle pattern: 


SIDLCT:: Idle pattern count byte 
SIDLFL:: Idle pattern flag byte 
SIDLPT: : Idle pattern word 


Days per month table: 

SDYPMN:: February....January 
Bit mask table: 

$BTMSK:: Bit mask table 


Online error logging data base: 


SERRHD: : Error logging message queue listhead 
SERRLM: : Limit on resident error logging data 
SERRSQ:: Universal error sequence number 
SERRSV:: Pointer to error file indentification 
SERRSZ:: Resident bytes of error logging data 
SIOABM: : Devive I/O active bitmap 


System bootstrap and save configuration vector: 
SSYSIZ:: Size of memory in 32W blocks 

Time Limit Parameters: 

STKPS:: Ticks per second 

Current time vector: 

STTNS:: Tick of second 


LIFO send and I/O preallocation list pointer 
parameters: 


SPKAVL:: Pointer to first packet in list 
SPKNUM: : Number of packets currently in list 


and 
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SPKMAX:: Maximum number allowed in list 


Global task size limit for extend task directive: 


SMXEXTs : Initialize to no limit (or reference 
UMR allocation listhead and wait queue listhead: 
SUMRHD:: Mapping assignment block listhead 


SUMRWT: : UMR wait queue listhead 


Macro Library Calls - 


HDRDFS 
HWDDFS 
TCBDFS 


Define task header offsets 
Define hardware registers 
Define task control block offsets 


Entry Point - None 


Input - None 


7.2.43 SYSDF Module 


SYSDF 


The SYSDF module globally defines the following: 
VSSCTR, defining the highest vector address 


SSSYDF, causing offset definitions from prefix files to be 


listed 
ITBDF$, defining ITB offsets and length 
PCBDFS$, defining PCB offsets and length 
SCBDFS, defining SCB offsets 
TCBDF$, defining TCB length 


The following directive status codes: 


D.RSl==-1. Insufficient dynamic core available to 


request 


label) 


satisfy 


D.RS2==-2. Specified task not installed in the system 


D.RS5==-5. Unassigned LUN 
D.RS6==-6. Driver not loaded 
D.RS7==-7. Task not active 


D.RS8==-8., Task not suspended, no data queued, 
checkpointing already enabled or disabled, AST 


recognition already enabled or disabled, 


entry already unspecified 
D.RS10==-10. Issuing task not checkpointable 
D.RS16==-16. Privilege violation 
D.RS17==-17. Vector already in use (CINTS) 
D.RS19==-19. Illegal vector (CINTS) 
D.RS80==-80. Directive issued from AST routine, 
not issued from AST routine 


D.RS81==-81. Cannot map ISR or disable-interrupt 


(CINTS) 
D.RS84==-84, Alignment error 
D.RS85==-85, Address window overflow 
D.RS86==-86. Invalid region ID 
D.RS87==-87. Invalid window ID 
D.RS90==-90. Specified LUN is locked in use 
D.RS92==-92., Invalid device or unit specified 
D.RS93==-93. Invalid time parameter 
D.RS94==-94, Partition or region not in system 
D.RS95==-95, Invalid priority 
D.RS96==-96. Invalid LUN 


directive 


routine 


task 
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D.RS97==-97. Invalid EFN or required EFN not specified 

D.RS98==-98, Part of DPB is outside of issuing task's 
address space 

D.RS99==-99. Invalid DIC or DPB size 

D.RS222=2. EFN was set 

D.RSO00==0. EFN was clear 


Global conditional assembly definitions: 

DSSYNM==0 Globally define DSSYNM if dynamic memory 
allocation is present 

MSSEXT==0 Globally define MSSEXT if 11/70 extended memory 
is present 

MSSMGE==0 Globally define MSSMGE if memory management is 
present 


Macro Library Calls - 


ITBDFS 
PCBDF$ 
SCBDF$ 
TCBDFS 
Entry Point 
Calls 
Input 


Output 


Define ITB offsets and length 

Define partition control block offsets and length 
Define status control block offsets 

Define task control block offsets 

- None 

None 


None 


None 


7.2.44 SYSTB Module 


SYSTB 


This module defines the system tables. 


Macro Library Calls - 


HWDDFS$ 
SCBDFS$ 
UCBDFS 


Entry Point 
$DEVTB: : 
Calls 

Input 
Output 


Note 


Define hardware registers 
Define SCB offsets 
Define UCB offsets 


This is the main entry point for the SYSTB module. It 
indicates the start of the device tables. 


None 
None 
None 


SYSTB is generated by SYSGEN 


7.2.45 SYSXT Module 


SYSXT 


SYSXT performs system entrance, exit and processor 
dispatching. SYSXT contains the following routines: 


SDIRSV:: Directive save routine 

SFORK: : Fork and create system process 
SFORK1:: Fork and create system process 
SFORKO:: Fork and create system process 
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SFORK2:: Fork routine to use with the CINTS directive 
SINTXT:: Interrupt exit processing 


SINTSC:: Interrupt save (interrupt connected to via a 
CINTS$ directive) 

SINTSE:: Interrupt save (error logging devices) 

SINTSV:: Interrupt save 

SINTXT: : Interrupt exit 

SDIRKXT: : Directive exit 


SNSO:: - SNS7::Nonsense interrupt entry (if error logging 
of undefined interrupts is not supported, all 
unused vectors point to the nonsense interrupt 
address). 

SNONSI:: Nonsense interrupt exit 


Fork routines are entered via a CALL with the arguments: 
R3 = Address of the beginning of the fork block+2 

R4 = Restored from fork block 

R5 = Restored from fork block 


Execute fork routine: (20$:) Removes entry form fork 
gueue, resets fork queue listhead, and allows 
interrupts, restores registers R4 and R5, 
calls the fork routine, and branches to SDIRXT 
to try to exit again. 


Rescheduling or powerfail routine: (40$:) Allows 
interrupts, tests for power failure. If power 
failure, executes a CALL to $POWER for power 
recovery and then branches to SDIRXT to try to 
exit again. If not power failure, goes to 
rescheduling routine. 


RESCH: Rescheduling routine 

SFINBF:: Finish terminal input buffered I/0 
S$SAVNR:: Save non-volatile registers 
SSWSTK:: Switch stacks 


Macro Library Calls - 


ABODFS$ 
HDRDF$ 
HWDDFS 
PCBDFS 
TCBDFS 
ITBDFS 


Entry Point 
SDIRSV:: 


Calls 


Input 


Output 


Define task abort codes 

Define task header offsets 

Define hardware registers 

Define partition control block offsets 
Define task control block offsets 
Define interrupt transfer block offsets 


Directive level trap service routines call S$DIRSV. The 
stack depth is +1, thus a switch to the system stack is 
always necessary. At the end of trap processing, a RETURN 
is executed to exit from system code. 


(R5) to call synchronous trap routine 


4(SP) = PS word pushed by trap 
2(SP) = PC word pushed by trap 
O0(SP) = Saved R5 pushed by “JSR R5,SDIRSV" 


SDIRSV pushes R4 onto the current stack and executes a 
switch to the system stack. SDIRSV pushes R3 through RO on 
the system stack, sets the new processor priority and 
calls the calling routine. 


Entry Point 
SFORK:: 


Calls 
Input 
Output 
Entry Point 


SFORK1:: 


Calls 


Input 


Output 


Entry Point 
SFORKO:: 


Input 


Output 


Entry Point 
SFORK2:: 


Calls 
Input 


Output 
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An I/O driver calls this routine to create a system 
process that returns to the driver at stack depth zero (0) 
to finish processing. $FORK saves R4 in the controller 
fork block. It points to the controller block, disables 
timeout, and points to the end of the fork block. 


None 
R5 = Address of the UCB for the unit being processed 


None 


This routine is an alternate entry to $FORK to create a 
system process and save R5. This routine consists of one 
instruction "MOV R5,-(R4)" that follows in line with the 
SFORK routine code. 


None 

R4 = Address of the last word of a 3-word fork block plus 
2 

R5 = Data to be saved in the fork block 


None 


The $FORKO entry point is a continuation of SFORK1 code. 
SFORKO sets the fork PC, saves current processor priority, 
locks out interrupts, and links the system process to the 
fork queue. S$FORKO then restores processor priority and 
executes a RETURN if CSSINT is defined. If CSSINT is not 
defined, the return is not executed and the code falls 
into the $FORK2 routine. 


R4 = Address of the last word of a 2-word fork block plus 
2 


None 


SFORK2 is the fork routine for use with the CINTS 
directive. $FORK2 tests to see if the fork block is 
already in use (fork PC non-zero). If it is, $FORK2 clears 
the stack and falls through to $INTXT, which executes a 
return. Otherwise, $FORK2 saves R4 in the fork block, 
points to the location just after the three word fork 
block and branches to $FORK1. The combination of S$FORK1, 
SFORKO, and $FORK2 create a system process, link the new 
fork entry in the fork gueue, restore processor priority, 
and end up at S$INTXT for the RETURN. . 


None 
R5 = Address of fork block in ITB 
If the fork block is not in use, $FORK2 saves R4 in the 


fork block, puts a pointer in R4 to point just after the 
3-word fork block, and clears the stack. 


Entry Point 
SINTXTs : 


Calls 
Input 
Output 


Entry Point 
SINTSC:: 


Calls 
Input 
Output 


Entry Point 
SINTSE:: 


Calls 
Input 
Output 


Entry Point 
SINTSV:: 


Calls 


Input 
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This is the interrupt exit routine. It contains only a 
RETURN instruction. A JUMP to this entry point causes an 
exit from an interrupt. 


None 
O(SP) = Interrupt save return address 


None 


Interrupt save routine (for interrupt from vector 
connected to via a CINTS directive). SINTSC saves R4 on 
the stack and checks for S$STKDP=0. If SSTKDP=0, SINTSC 
loads ISR priority, calls ISR, and branches to SINTX1 to 
exit from interrupt. If S$STKDP not = 0, SINTSC saves stack 
pointer in header, loads the system stack pointer, loads 
ISR priority, calls ISR, and branches to S$INTX1 for 
interrupt exit. 


@(R5)+ to call ISR 
None 


None 


This is the interrupt save routine for error logging 
devices. An interrupt service routine calls S$INTSE when an 
interrupt is not to be immediately serviced. S$INTSE saves 
R4 and thens loads R4 with the address of the SCB of the 
controller that caused the interrupt. SINTSE then checks 
if an error is already in progress. If not, SINTSE saves 
the current I/O active bitmap and loads R4 with the 
controller index. SINTSE code finishes in the SINTSV code 
to execute an interrupt save. 


None 
4(SP) = PS word pushed by interrupt 
2(SP) = PC word pushed by interrupt 
0(SP) = Saved R5 pushed by "JSR R5,SINTSE" 
RS = Address of the SCB of interrupting controller 
2(R5) = New processor priority 


R4 = Controller index. 
The bit is cleared in the bitmap. 


This is the interrupt save routine. An interrupt service 
routine calls this routine when an interrupt is not to be 
immediately dismissed. SINTSV switches to the system stack 
if the current stack depth is +1. When the interrupt 
service routine is finished processing, it forks, jumps to 
SINTXT, or executes a return. 


2(R5) to call the caller back 
(R5) to call the caller back if L$$SI1 is not defined 


4(SP) = PS word pushed by interrupt 
2(SP) = PC word pushed by interrupt 


Output 


Entry Point 
SINTX1:: 


Calls 


Input 


Output 


Entry Point 
SDIRXT:: 


Calls 


Input 
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0(SP) = Saved R5 pushed by "JSR R5,SINTSV" 
R5 = New processor priority 


Switch to system stack if stack depth is +1 


New processor priority is loaded 


This is the interrupt exit routine. This routine is 
entered from a return to exit from an interrupt. SINTX1 
locks out interrupts and if the stack depth is not = 0, 
SINTX1 branches to S$DIRXT to increment the stack depth and 
restore registers R4 and R5; then, $DIRXT executes an RTI 
instruction. If the stack depth is zero, S$INTX1 checks for 
entries in the fork gueve. If the fork queue is empty, 
SINTX1 branches to S$DIRXT to increment the stack depth, 
restore registers R4 and R5, and execute an RTI 
instruction. If the fork gueue is not empty, SINTX1 allows 
interrupts, saves registers RO-R3 on the current stack, 
and proceeds to $DIRXT directive exit code. 


None 

06(SP) = PS word pushed by interrupt 
04(sp) = pe word pushed by interrupt 
02(SP) = Saved R5 

00(SP) = Saved R4 

None 


This is the directive exit processing routine. A directive 
processing routine or a trap service routine use a JUMP to 
enter this routine for exit. If there are any entries’ in 
the fork queue, S$DIRXT removes the first entry and 
executes the fork routine. If there are no entries in the 
fork queue, $DIRXT checks to see if redispatching of the 
processor is necessary. If not, $DIRXT restores RO-R5 and 
executes an RTI instrution. If processor redispatching is 
necessary, the processor is redispatched and SDIRXT 
executes the exit seguence again. 


@-(R3) to call fork routine 

SPOWER to call power recovery routine 

SABCTK to abort current task 

SQRMVF to remove ast entry from gueue 

SACHCK to address check stack space 

SRELOM to relocate and map stack address 
@(RO)+ or @=-2(RO) to call degueuve subroutine 
SDEACB to deallocate control block 

SDREXT to force task exit 


Inputs for mapped system: 
16(SP) = PS word pushed by interrupt or trap 


14(SP) = PC word pushed by interrupt or trap 
12(SP) = Saved R5 
10(SP) = Saved R4 
06(SP) = Saved R3 
04(SP) = Saved R2 
02(SP) = Saved Rl 
00(SP) = Saved RO 


7-87 


Output 


Entry Point 
SFINBF:: 


Calls 


Input 
Output 
Entry Point 
SSAVNR:: 
Calls 

Input 
Output 


Entry Point 
SSWSTK:: 


Calls 


Input 
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Inputs for unmapped system: 
06(SP) = Saved R3 
04(SP) = Saved R2 
02(SP) = Saved R1 
00(SP) = Saved RO 


For outputs of the SDIRXT routine, consult the interrupt 
processing logic diagrams in this manual. 


This routine finishes terminal input buffered I/O. It is 
called to finish a buffered terminal input request that 
has been placed in the AST gueue. 


SRELOC to relocate I/O status block 
SIOFIN to finish I/O operation 
SDEACB to deallocate input buffer 
RO = Address of I/O packet 


SFINBF transfers the buffered I/O to the user task and 
calls S$IOFIN to finish the I/O reguest. 


This is a co-routine that saves registers R4 and R5. 
@(SP)+ to call the caller 

R4 and R5, which are the registers to be saved. 
SSAVNR saves R4 and R5 on the stack. 


A task calls this routine to switch to the system stack, 
thus inhibiting task switching. The calling task must be 
privileged if running in a mapped system and mapped to the 
exec. Control is passed here from S$DRDSP after the trap 
has occured and $DIRSV has been called. 


The calling sequence is: 

EMT 376 Trap to SEMSST in DRDSP 

» WORD ADDR Address for return to user state 
@(SP)+ to call the calling routine 

R3 = Address of PC word of trap on stack +2 


Inputs for a mapped system: 


22(SP) = PS pushed by trap 
20(SP) = PC pushed by trap 
16(SP) = Saved R5 

14(SP) = Saved R4 

12(SP) = Saved R3 

10(SP) = Saved R2 

06(SP) = Saved Rl 

04(SP) = Saved RO 

02(SP) = Return address for system exit 
OO(SP) = 104376 

Inputs for an unmapped system: 
10(SP) = Saved R3 

06(SP) = Saved R2 

04(SP) = Saved R1 


Output 
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Q02(SP) = Saved R0 
00(SP) = Return address for system exit 


SSWSTK calls the user back on the system stack with all 
registers preserved. To return to task level the user 
executes a return. 


7.2.46 TDSCH Module 


TDSCH 


This module processes time dependent scheduling and device 
time-outs. 


Macro Library Calls - 


CLKDF$ 
HDRDFS$ 
HWDDF$ 
TCBDF$ 
PCBDFS$ 


Entry Point 
SCKINT:: 


Calls 


Define clock queue control block offsets 
Define task header offsets 

Define hardware registers 

Define task control block offsets 

Define partition control block offsets 


A clock interrupt causes the system to enter this routine. 
SCKINT calls SINTSV to save R4 and R5 and increments the 
interrupt count. If the result is non-zero, SCKINT 
executes a JUMP to SINTXT. If the count is zero, $CKINT 
calls $FORKO to execute fork and process clock interrupts. 


SINTSV to save registers and set priority 
SFORKO to execute fork and process clock interrupts 


UPTIM: - Update absolute and real time of day and date: 
None 


TDS: - Time dependent scheduling: 
SEXRQN to clear stop bit and reallocate partition 


Single-shot internal system subroutine (type 6 or 8): 
@C.SUB(R4) to call system subroutine 


Mark time request: 
SSETM to set event flag 
SQASTT to gueue AST to task 


Schedule request: 

STSKRT to request task execution 

SDECLK to deallocate control block 
SCLINS to reinsert entry in clock gueue 
@(SP)+ to get next UCB address 


@D.VOUT(R1): - Call driver at timeout entry point with the 
arguments: 
RO = Device timeout status "IE.DNR" 


R2 = Address of device CSR 

R3 = Controller index 

R4 = Address of the status control block 
R5 = 


Address of the unit control block 


ROBIN: - Executive level round robin scheduling 
SDRDSE cause a redispatch of processor 


SWAP: - Disk swapping algorithm; reduce sapping priority 
of resident tasks 
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SNXTSK Reallocate partition 


TIMXT: ~- Exit time dependent scheduling if no unprocessed 
clock ticks remain 
Input None 


Output none 


CHAPTER 8 


DATA AREAS AND CONTROL BLOCKS 


8.1 INTRODUCTION 


This chapter describes the system control block linkages and data 
structures. The control blocks were taken from system code. However, 
while transposing the system code into this manual, editorial changes 
were made for the sake of appearance and clarity. The beginning of 
the chapter describes system pointers and typical system linkages 
followed by a discussion of I/O linkages as related to I/O drivers. 
The remainder of the chapter contains the system control block offset 
descriptions and describes the system control blocks and data areas in 
alphabetical order. 


8.2 SYSTEM POINTERS AND LINKAGES 


Figure 8-1, Linked Lists on RSX-11M, describes the typical way that 
control block lists are linked in RSX-l1M. Figure 8-2, Overview of 
RSX-11M System Control Blocks, contains an overview of the way that 
RSX-11M system control blocks are linked together. This figure shows 
the major system lists, list pointers, and linkages only. More 
detailed linkages and control block configurations are shown in 
Figures 8-3 through 8-24. 
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LISTS HEADED BY POINTER 


POINTER 1 POINTER POINTER 


@ For an Empty List the Initial Pointer is 0. In any Case, the Last Pointer Is 0 


LISTS HEADED BY LISTHEADS 


LISTHEAD 
POINTER POINTER 


@ For an Empty List the First Word of the Listhiead is 0 and the Second Contains the Address of the First 


Figure 8-1 Linked Lists on RSX-11M 
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8.2.1 Device Control Block Pointer (SDEVHD) 


The location, S$DEVHD, which is in SYSCM, contains the address of the 
label, SDEVTB. S$DEVTB is the label of the first DCB of a list of DCBs 
in the system. 


SYSGEN produces SYSTB, which contains the DCBs, UCBs, and SCBs for the 
system as well as the label, $DEVTB::. The Task Builder resolves the 
references to the first DCB (SDEVTB) when it links SYSTB into the 
Executive. 


The DCBs are linked by the first word in each DCB, D.LNK. D.LNK 
contains the address of the next DCB in the chain. Typically, when 
the Executive works with the DCB, R3 contains the address of the DCB. 
To access the next DCB, the Executive executes a MOV @R3,R3 
instruction. 


The DCBs and UCBs in SYSTB contain the logical name, logical unit 
number, and device characteristics of the devices in the system. In 
general, the DCB contains device-unit information common to all 
device-units of the same type on a controller. This kind of structure 
saves space because, otherwise, this common information would have to 
appear in the UCB for each device-unit. 


The DCB contains the device name; for example, the DCB for DKO; 
contains "DK" in ASCII. With one exception, there is only one DCB 
with the name of a given device in it. The exception occurs when 
there is a DCB for every kind of terminal device controller in the 
system (DL, DJ, DH, or DZ); however, they all contain the device name 
tmpn : 


There are two types of DCB; one for real devices and one for pseudo 
devices, Nothing in the DCB denotes its use for a real or pseudo 
device. However, the UCB associated with the DCB contains the bit, 
DV.PSE, which identifies the associated device as a pseudo device. 


An Executive co-routine, $SCNDT, is used to scan all the addresses of 
the DCBs and UCBs in the system up to but not including the first 
pseudo device. For example, the address of the DCB for TI: cannot be 
found by using this co-routine. 


8.2.2 Unit Control Blocks 


A UCB exists for each device-unit on the system. D.UCB, which is a 
word in the DCB, contains a pointer to the first UCB for that DCB. 
There is at least one UCB for each DCB; however, there can be more 
than one UCB for each DCB. 


For an example of a DCB-UCB relationship, a system has four identical 
disk drives on one controller. The disk device-units would have 
physical unit numbers from 0 through 3 and logical unit numbers from 0 
through 3. In this configuration, there is one DCB (all device-units 
are the same), four UCBs (one for each device-unit), and one Status 
Control Block (SCB) for the controller. In this example, only one 
drive can be operated at a time. 


For another example, a system has four identical disk drives; two 
connected to controller 0 and two connected to controller 1. The two 
drives on controller 0 have physical unit numbers 0 and 1, and logical 
unit numbers 0 andl. The two drives on controller 1 have physical 
unit numbers 0 and 1, and logical unit numbers 3 and 4. In this 
configuration, there is one DCB (all device units are the same), four 
UCBs (one for each device-unit), and ‘two SCBs (one for each 
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controller). In this example, two drives can operate in parallel as 
long as they are on different controllers: that is, the drives with 
logical unit numbers 0 and 2 or 0 and 3, or the drives with logical 
unit numbers 1 and 2 or 1 and33. 


The UCB contains pointers and device status information. 


8.2.3 Status Control Block (SCB) 


There is one Status Control Block for each controller on the system 
and it contains controller status information. The UCB points to the 
related SCB. See the discussion that precedes the word and bit 
definitions for the Status Control Block. 


8.2.4 Partition Control Block (PCB) Pointer 
SPARHD is the pointer to the first PCB in the chain of system PCBs. 


System- and user-controlled partitions can be differentiated by 
examining the form of their PCB linkage. 


In a user-controlled partition PCB, P.LNK of this PCB points to the 
first word, P.LNK, of the next subpartition PCB. P.SUB in the first 
PCB also points to P.LNK of the next PCB. P.MAIN, which is in 
user-controlled partition and subpartition PCBs, points back to the 
main partition PCB that heads the list of subpartition PCBs. In a 
user-controlled main partition PCB without subpartitions, P.SUB is 0. 
However, if the main partition has subpartitions, P.SUB in the last 
subpartition PCB is zero. 


This linkage is slightly different in system-controlled partitions. 
The dynamically created subpartition PCBs are not linked by P.LNK; 
only P.SUB points to the first word, P.LNK, of the next PCB in the 
chain of PCBs. P,MAIN in each system-controlled partition or 
subpartition points back to the main PCB. In a PCB for a 
system-controlled partition without dynamically created subpartitions. 
P.LNK is 0. If the partition has subpartitions, P.SUB in the last 
subpartition PCB is 0. 


See Figure 8-3 for an example of a system- and user-controlled 
partition list. 


8.2.5 Task Control Block (TCB) Pointers (STSKHD And SACTHD) 


Task Control Blocks (TCBs) are listed in several lists. One is the 
System Task Directory (STD), a list (ordered by priority) of all 
installed tasks. Another is the Active Task List (ATL), a list of 
tasks that are currently active. The ATL is a subset of the STD; 
therefore, TCBs that are linked into the ATL are also linked into the 
STD. 


STSKHD points to the first TCB in the STD. The remaining TCBs in the 
STD are linked by the word, T.TCBL. S$TSKHD points to T.LNK in the 
first TCB, T.TCBL in the first TCB points to T.LNK in the next TCB, 
and so on. 


SACTHD points to the first TCB in the ATL. The word, T.ACTL, links 


the remaining active task TCBs. T.ACTL in the last TCB word is 0; 
this indicates the TCB of the Null task. 
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The Partition Wait Queue is a list of TCBs of those tasks waiting to 
use a given partition. The word, P.WAIT, in the PCB points to the 
first TCB in the Partition Wait Queue. T.LNK in the first TCB points 
to the T.LNK word in the second TCB, T.LNK in the second TCB points to 
the T.LNK word in the third TCB, and so on. 


8.2.6 Reschedule Pointer ($RQSCH) 


The reschedule pointer, $RQSCH, contains the address of the TCB of the 
task to be rescheduled. 


8.2.7 Current Task Pointer (STKTCB) 


The current task pointer, S$TKTCB, contains the address of the TCB of 
the currently running task. 


8.2.8 Loader Pointer (SLDRPT) 


Normally, $LDRPT is the pointer to the TCB of the Loader task. 


8.2.9 Task Termination Task Pointer ($TKNPT) 


STKNPT points to the TCB of the Task Termination Task. 


8.2.10 Pree Storage Block Pointer (S$CRAVL) 


SCRAVL points to the first free block in a list of free storage blocks 
in the Dynamic Storage Region. $CRAVL-2 is a word that contains a 3 
and should never contain less than a 3. This number is one less’ than 
the number of bytes in the smallest possible block obtainable from the 
Dynamic Storage Region. This number 3 is a rounding factor. In other 
words, the size of the smallest allocatable memory block is 4 bytes 
and memory must be allocated in multiples of 4 bytes. Four bytes are 
needed because every free memory block must contain a pointer to the 
next block, followed by its own size in bytes. This information uses 
up 2 words of the block. 


Initially, the Dynamic Storage Region is a continuouS memory area. 


However, it becomes somewhat fragmented after the system begins 
execution. 


8.2.11 Fork Queue List Pointer ($FRKHD) 


SFRKHD is a pointer to a list of SCBs in the fork gueue. 


8.2.12 Clock Queue Pointer (SCLKHD) 


SCLKHD is a pointer to a list of 8=word clock queue control blocks. 
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8.2.13 Current Task Header Pointer ($HEADR) 

S$HEADR points to the current task header. In a mapped system, the 
Executive copies the task header into the DSR. Only privileged tasks 
can access this copy; the Executive refers to and modifies this copy 
as execution proceeds. Therefore, the original header of the current 
task may not contain valid information because the valid header is in 


the DSR space. Before the task is checkpointed, the Executive 
replaces the original header with the copy in the DSR. 


8.2.14 Examples Of System Linkages 


Figure 8-3 contains an example of a PCB linkage for user- and 
system-controlled partitions. 


Figure 8-4 shows TCB wait queues in user- and system-controlled 
partitions. 


Figure 8-5 shows checkpoint file PCBs with and without checkpointed 
task TCBs. 


Figure 8-6 shows an example of TCBs linked into a System Task 
Directory with some of the TCBs in the Active Task List. 


Figure 8-7 shows a simplified linkage of the PCB, TCBs, and task 
header in a task partition. 


Figure 8-8 shows a linkage of TCBs for resident and non-resident tasks 
with their respective PCBs. 


Figure 8-9 shows AST control blocks in the AST queue. 
Figure 8-10 shows TCBs of tasks in the Loader queue. 


Figure 8-11 shows Send/Receive data blocks queued to the receiver task 
TCB. 


Figure 8-12 shows Send/Receive-by-Reference blocks queued to the 
receiver task TCB. 


Figure 8-13 shows the linkage of Clock Queue Control Blocks. 
Figure 8-14 shows the linkage of the Fork Control Blocks. 


Figure 8-15 shows an example of DCBs, SCBs, UCBs, and LCBs in system. 
It also shows the linkage caused by redirected and reassigned devices. 


Figure 8-16 Shows the Logical Assignment Control Block linkage. 
Figure 8-17 shows the linkage of MCR gueue entries. 
Figure 8-18 shows the linkage of pre~allocated I/O packets. 


Figure 8-19 shows Message Blocks in the Task Termination Notification 
(TKTN) queue. 


Figure 8-20 shows the linkage of the free blocks in the Dynamic 
Storage Region. 
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PARTITION LIST 


SPARHD 


USER-CONTROLLED 
MAIN PARTITION 
WITHOUT SUBPARTITIONS 


USER-CONTROLLED 
MAIN PARTITION 
WITH 2 SUBPARTITIONS 


SYSTEM-CONTROLLED 
PARTITION WITH 

2 DYNAMICALLY 
CREATED SUBPARTITIONS 


P. LNK=? 


| 
PCB'S OF DYNAMICALLY ALLOCATED 
SUBPARTITIONS ARE CHAINED ACCORDING 
TO THE BASE ADDRESSES OF THEIR SUBPARTITIONS 


Figure 8-3 Example of PCB Listings 
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= P. LNK 
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_ | T. LNK a 


P.WAIT [oo = 
— WAIT QUEUE OF A 
. USER CONTROLLED 
T. PCB MAIN PARTITION 
Bee SUBPART! 
Pe ed SUBPARTITION 


fe a 
Baars 
XT 


T.LNK 


T. LINK 


T. PCB 


P. SUB=@ 


P.WAIT Ld 


WAIT QUEUE OF A SYSTEM 
CONTROLLED PARTITION 
WITH ONE TASK 

ALREADY RESIDENT 


P. SUB=@ P, SUB=9 


P, LNK=? 
P, SUB=9 


TCB‘S OF WAITING TASKS ARE CHAINED ACCORDING 
TO THE RUNNING PRIORITY OF THE TASKS IN 
DESCENDING ORDER. 


e The main PCB always heads the Partition Wait Queue. The 
Partition Wait Queue contains TCBs both of tasks to be loaded 
for the first time and of checkpointed tasks. 


Figure 8-4 Example of a Partition Wait Queue 
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P. MAIN=0 


CHECKPOINT FILE 
WITH 2 CHECKPOINTED 
TASKS IN IT. 


CHECKPOINT FILE 
CURRENTLY NOT USED 


@e PCBs for checkpoint files are allocated by the MCR command: 
ACS devunit: /BLKS=no. of blocks 
The PCBs are chained in the order of their allocation. 
® PCBs for checkpointed tasks are dynamically allocated whenever 


the Executive checkpoints a task and are chained in ascending 
order according to base disk address. 


Figure 8-5 Example of a PCB List for Checkpoint Files 
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$ TSKHO e STSKHD points to the start of the 
$ ACTHD STD. 
248 . e SACTHD points to the start of the 
ATL. 


T. TCBL 


iia 


T. ACTL 
ae ea 


Peavy} e S$TKTCB points to the current task. 


LOADER TASK @ SRQSCH points to where the Executive 
starts scanning the ATL. 

e A task is put into the STD by the 
Install command and removed by the 
Remove command. 

e The STD is linked in descending 
order according to the default 
priority. 

e The ATL is linked according to the 
running and default priority in 
descending order, 

e The default priority is defined when 
the task is installed: 

_ €KB-option PRI#=n 

INS filespec/PRI=n 

RUN filespec/PRI=n 
default=50. 

ALT taskname/PRI=n 

e The running priority is defined by: 

ALT taskname/PRI=n 

ALT taskname/RPRI=n 

ALTPS directive 

default: default priority 

e The round robin scheduler 
periodically reorders the tasks of 
the same numeric running priority 
within the ATL; it does not affect 
the STD. 

e The swapping algorithm does not 
affect the STD or the ATL. 

e The following are pointers to TCBs 
of special tasks: 

SLDRPT points to the Loader TCB 

SMCRPT points to the MCR TCB 

STKNPT points to the task 
termination notification task 
TCB 

SSHFPT points to the shuffler 
TCB 

SERRPT points to the error 
logger TCB 


$ RQSCH 


Ca 
LT. TCBL 

eas 
| T.ACTL 


T.PRI 
T. TCBL=9 


TCB OF 
NULL TASK 


T. ACTL=@ 
aS 


Figure 8-6 Example of a System Task Directory (STD) and Active Task List 
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NON-RESIDENT 


TASK TCB 
PCB OF TASK 
PARTITION 
(MAIN OR SUBP) 
TCB 
RESIDENT TASK 
TASK 
HEADER 


Figure 8-7 Simplified User-Controlled 
Partition TCB, Task Header, and PCB Relationship 
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NON-RESIDENT, 
NON-ACTIVE TASK 


RESIDENT TASK 
TASK 
HEADER 


NON-RESIDENT, 
ACTIVE TASK 


TCB 
OTHER 
RESIDENT 
TASK 
TASK 
HEADER 
Figure 8-8 TCB, Task Header, and PCB 


Relationships in a System-Controlled Partition 
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ice coe eee 
T. ASTL Pn 


TCB 


AST AST AST 
ONTROL BLOCK CONTROL BLOCK 
CONTROL BLOCK FOR FOR 
FOR RECEIVE DATA MARK TIME 
1/0. COMPLETION 
H. PFVA 
Mens = TH. PFVA=0 | AST 
H. RCVA=@ CONTROL BLOCK 
oe on eae FOR 1/0 PACKET 
MARK TIME 
H.RRVA =@ RECEIVE DATA 


AST 


CONTROL BLOCK 
FOR 
POWER FAILURE 


@ AST control blocks are queued FIFO. 


e AST control blocks for power failure, floating-point 
exception, Receive Data, and Receive-by-Reference are 
allocated a length of C.LGTH#=16. bytes. They are deallocated 
by the STRAS$, SFFA$, SRDA$, and SRRAS$ directives. Their 
addresses are kept in the task header. When an AST is 
executed, the AST control block is inserted into the AST 
gueue. After the AST has been set up, the AST control block 
address is again put into the task header. 


@e The AST control block for Mark Time is allocated a length of 
C.LGTH#16. bytes by the MRKTS directive and inserted into the 
clock gueue. When the mark time becomes due, the AST control 
block is removed from the clock queue and inserted into the 
AST gueue. After the AST has been set up, the AST control 
block is deallocated. 


e For the I/O completion AST, the I/O packet is taken and 


inserted into the AST gueve. After the AST has been set up, 
the AST control block (I/O packet) is deallocated. 


Figure 8-9 Example of an AST gueue 
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LOADER 
TCB 
$LDRPT 
| TcB 
sae 
LOA 


TASK 


en) 


TCBs OF TASKS TO BE LOADED OR ROLLED 
OUT/IN ARE CHAINED ACCORDING TO THE 
RUNNING PRIORITY OF THE TASKS IN 
DESCENDING ORDER. 


@ The Loader gueve is headed by the TCB of the loader task and 
contains TCBs of both tasks to be loaded the first time and 
the task to be checkpointed. 


Figure 8-10 The Loader Queue 


TCB OF 
RECEIVER 
TASK 


e Send/Receive data blocks are gueued FIFO. 
@® Send/Receive data blocks are queued by issuing the SDATS 


directive and degqueued when the RCVDS$ or RCVXS$ directives are 
issued. 


Figure 8-11 Send/Receive Data Queue 
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RECEIVER 


TASK 


SREF$S directive 


T. RREL 


issued. 


SCLKHD 


Figure 8-12 


C. LNK=@ 


Send/Receive-by-Reference blocks are gueued FIFO. 


Send/Receive-by-Reference blocks are gueued by issuing the 
and degqueued when the RREFS$ directive is 


Send/Receive by Reference Queue 


The clock queue is linked in ascending 
order according to the absolute time when 
the events described by the Clock Queue 
Control Block come due. 


The l-word counter, SABTIM, is incremented 
with each clock tick. Whenever it 
overflows, the high-order word of the 
absolute time in each clock queve is 
decremented. 


An event comes due when the high-order of 
the absolute time in its Clock Queue 
Control Block is 0 and the low-order 

word of the absolute time is less than or 
egual ‘to the counter, SABTIM. 


The Clock Queue Control Block is 

conditionally deallocated when the event 

comes due dependent on the type of Clock 

Queue Control Block: 

Type 0 - Used as AST control block (if 
specified), otherwise deallocated 

Type 2 - Queuved again 

Type 4 - Deallocated 

Type 6, 10, or 12 = Not deallocated 


Figure 8-13 The Clock Queue 
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sites SE: 


@ Fork control blocks are queued FIFO 


@ Fork contro! blocks are queued by issuing a $FORK, SFORK1 or 
$FORKG call; the control goes back to the next higher subroutine 
level 


®@ Fork processes (instructions following the CALL $FOR Kn instruction 
up to the next RETURN instruction) are executed before the system 
goes back to user level the next time (SSTKDP is changed from 
@ to 1) 


FORK CONTROL BLOCK 


LOADABLE DRIVER 


12 SUPPORT ONLY 


Figure 8-14 The Fork Queue 
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“PARTIAL UCB. 
USES UCB FOR 


.DBO 


pe 
© 
a 


® LP REDIRECTED TO TT2 
© SY REDIRECTED TO DB6 


GLOBAL ASSIGNMENTS 


LOGIN ASSIGNMENTS 


LOCAL ASSIGNMENTS 


Figure 8-15 Example of DCB, SCB, UCB, LCB Relationship 
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$ LOGHD 


LOGIN 


GLOBAL 


LOGICAL ASSIGNMENT CONTROL BLOCK (LCB) 


LINK TO NEXT LCB 


® An LCB is allocated by issuing an : 
ASN target device = logical soli /LOGIN [/TERM = terminal] } command 
/GBL 
and deallocated by issuing an : 
ASN = {logical device] /LOGIN eee terminal] ; command 


@ There are three groups of logical assignments: 


1. local assignments applying to one specific terminal only 

2. login assignments applying to one specific terminal only where 
a user is logged in, they are established either at login time 
or when a login logical assignment command is issued 

3. global assignments valid for all terminals in the system 


@ LCBs are linked local assignments first, then login assignments and 
global assignments at the end; within each group they are linked according 
to the time the logical assignment was established 


@ Logical assignments are resolved by scanning the linked list of LCB’s 
when a logical unit number is assigned to a physical device (at install 
time or at run time when a ALUNG directive is issued) 


@ Symbolic offset definitions in LCBDFS in [1,1] EXEMC.MLB 


Figure 8-16 Logical Assignment Control Block (LCB) List 
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$MCRPT 
~ POINTER TO 
NEXT BLOCK 
TROVE. UCB OF REQUESTING UCB OF REQUESTING 
TERMINAL TERMINAL 
@ MCR queue entries are allocated in a length of 84. bytes (M$$CRB) 
@ MCR queue entries are linked FIFO 
e@ Entries are inserted by the terminal driver whenever an unsolicited 
input is completed or when a line is finished being typed in after an 
MCR> prompt that follows.a control-C. 
@ Entries are dequeued by the MCR root; internal MCR commands 
are processed by the corresponding overlay segment; MCR queue 
entries for external MCR commands are inserted into the following 
queue 
SMCRCE POINTER TO POINTER TO 
NEXT BLOCK NEXT BLOCK 


UCB OF REQUESTING UCB OF REQUESTING 
TERMINAL TERMINAL 


@ MCR queue entries in this list are dequeued when an external 
MCR command (a task with a taskname ... XYZ) issues a GMCRS$ 
directive; the contents of the entry is copied into the DPB of the 
GMCRS$ directive and the MCR queue entry is deallocated 


Figure 8-17 MCR Queues 
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SPKAVL | POINTER TO FIRST I/O PACKET 


MAX NO. OF 
PACKETS 

ALLOWED IN 
LIST 


“NO. OF PACKETS 
CURRENTLY 
IN LIST 


SPKNUM $PKMAX 


®@ Each preallocated {/O packet has a length ot 44 bytes. 


@ Preallocated I/O packets are provided - as long as 
available - whenever $ALOCEB is called and a core block 
with a length of 44 bytes is requested. 


@ Preallocated !/O packets can and will be used for other 
purposes also. 


Figure 8-18 Pre-allocated I/O Packet Queue 
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STKNPT 


a POINTER TO = 


NEXT BLOCK 


MESSAGE NUMBER 


UCB/TCB ADDRESS 


MESSAGE NUMBER 
UCB/TCB ADDRESS 


T. RCVL 


® The queue is linked FIFO 
@ Anentry is made when the routine $DYMSG is called 
As a second TKTN queue the active task list (ATL) is used. 


There are two types of ATL entries significant for the TKTN: 


@ TCBs (with the TS.MSG bit in T. STAT and the T2. ABO bit in T. ST2 set) 
of aborted tasks or an exited task with outstanding 1/0 in which case 


@ TCBs (with the T2, CAF bit in T. ST2 set and the T3. CAL bit in T. ST3 clear) 
of tasks with a checkpoint allocation failure 


Figure 8-19 Task Termination Notification (TKTN) Queues 
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igure 8-20 Dynamic Storage Region Free Block Queue 
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8.2.15 Interrelationship Of The DCB, UCB, And SCB 


This section discusses the relationships existing among the DCB, UCB, 
and SCB. 


Figure 8-21 shows the data structure resulting from three LA36 
DECwriters interfaced by means of a DH11 multiplexer. The structure 
reguires one DCB, three UCBs, and three SCBs, because activity on all 
three units can proceed in parallel. 


Figure 8-22 shows the internal data structure for an RKI11 disk 
controller with three units attached. Note that only one SCB exists 
because only one of the three units can be active at any given time. 


Figure 8-23 shows the data structure for two RK11 disk controllers, 
each of which has two drives attached. Here, there are two SCBs, 
because both of the disk controllers can operate in parellel. 


Taken together, Figures 8-21, 8-22, and 8-23 illustrate the strategy 
underlying the existence of three basic I/O control block types. 
There need be only one DCB for each device type. There may be one or 
more SCBs, depending on the degree of parallelism that is desired or 
possible: one for each device-unit, or one for each controller 
servicing several device-units. The number of UCBs and SCBs, and 
their interrelationships, are uniguely determined by the hardware that 
these data structures describe. 


This data structure provides considerable flexibility in configuring 
I/O devices, and, because of the control and status in the structures 
themselves, substantially reduces the code reguirements of the 
associated drivers. 


Figure 8-21 DH11 Terminal I/O Data Structure 
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Figure 8-22 RK11 Disk I/O Data Structure 


Figure 8-23 I/O Data Structure for Two RK11 Disk Controllers 
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8.3 I/O CONTROL BLOCK LINKAGES 
This section discusses all the I/O control blocks, in terms of their 
linkage and use within the system. The following data structures make 
up the complete set for I/O processing: 

l. Task Header 

2. Window Block (WB) 

3. File Control Block (FCB) 


4. $DEVHD word, the Device Control Block (DCB), and the Driver 
Dispatch Table (DDT) ; 


5. Unit Control Block (UCB) 

6. Status Control Block (SCB) 

7. %1I/O0 Queue 

8. Volume Control Block (VCB) 
Figure 8-24, which provides the structure for the following 
discussion, shows all the individual data structures and the important 


link fields within them. The numbers on the figure are keyed to the 


text to simplify the discussion and to guide the reader through the 
data structures. 
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Figure 8-24 I/O Data Structure 
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The task header is constructed during the task-build process. 
In mapped systems, a copy of the task header (located in the 
task's partition) is made in the Executive's Dynamic Storage 
Region. The Executive then uses this copy. To access the 
current information in this copy, a task must be privileged 
and mapped to the Executive. 


The task header entry of interest, the Logical Unit Table 
(LUT), is allocated by the Task Builder and filled in at task 
installation. The number of LUT entries is established by 
the UNITS= keyword option; this number is an upper limit on 
the number of device units a_ task may have active 
simultaneously. 


Each LUT entry contains two words: a pointer to an 
associated UCB, anda pointer to a Window Block. The first 
word contains the address of the device UCB in the Executive 
system tables that contains drive-dependent information. The 
UCB address is set during task installation if a 
corresponding ASG= option is specified at task build time. 
The UCB address can also be set at run-time with the Assign 
LUN directive to the Executive. 


The second word is a pointer to the Window Block if the 
device is file structured. The Window Block pointer is set 
when a file is opened on the device whose UCB address is 
specified by the first word. The Window Block pointer is 
cleared when the file is closed. 


A Window Block (WB) exists for each active access to files on 
a mounted volume. It helps to speed up the retrieval of data 
items in the file; entries in a WB consist mainly of 
pointers to contiguous areas on the device on which the file 
resides. The driver is net concerned with the WB. 


Each uniquely opened file on a mounted volume has an 
associated File Control Block (FCB). The file system uses 
the FCB to control access to the file. 


SDEVHD is a word located in system common (SYSCM) and points 
to a singly linked, unidirectional list of Device Control 
Blocks (DCBs). Each device type in a system has at least one 
associated DCB. The DCB list is terminated by a 0 in the 
link word. 


Linked to each DCB is a Driver Dispatch Table (DDT), which is 
part of the driver. The DDT contains the addresses of the 
driver's four entry points that the Executive can call. 


A key data structure is the Unit Control Block (UCB). All 
the UCBs associated with a DCB appear in consecutive memory 
locations. During internal processing of a I/O request, most 
drivers set R5 to the address of the related UCB; it is by 
means of pointers in the UCB that the driver can access other 
control blocks in the data structure. In particular, the UCB 
contains pointers to the DCB, SCB, VCB, and to the UCB to 
which it may have been redirected. If a Redirect command has 
not been issued for the device-unit, the UCB redirect pointer 
points to the UCB itself. When servicing a request for one 
of its UCBs, the driver is unaware of whether I/O was’ issued 
directly to its own UCB or to a UCB that had been redirected 
to its UCB. 
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One Status Control Block (SCB) exists for each controller in 
the system, A unigue SCB must exist for each 
controller/device-unit capable of performing parallel I/O. 
The SCB contains the fork-block storage required when a 
driver calls $FORK to transfer itself to the fork processing 
level. The I/O request queue listhead is also contained in 
the SCB. Generally, register R4 contains the address of the 
SCB during processing of an I/O request. 


The I/O gueve is a list of control blocks called I/O packets 
that QIO processing creates dynamically. Each time a task 
makes an I/O request, the Executive performs a series of 
validity checks on the DPB parameters. If these checks prove 
successful, the Executive generates a data structure called 
an I/O packet. The Executive then inserts the packet into a 
device-specific, priority-ordered list of packets called the 
I/O queue. Each I/O gueue's listhead is in the SCB to which 
the I/O requests apply. 


When a device driver needs work, it requests the Executive to 
dequeue the next I/O packet and deliver it to the requesting 
driver. Normally, the driver does not directly manipulate 
the I/O queue. However, an exception is the case where a 
driver examines an I/O packet before it is queued, or in 
place of having it queued. For the driver to accomplish this 
examination, it must set the UC.QUE bit in the control byte, 
U.CTL, of the UCB. 


The most common reason for a driver to examine a packet 
before queuing is that the driver employs a special user 
buffer, other than the normal buffer used in a_ transfer 
request. Within the context of the requesting task, the 
driver must address-check and relocate such a special buffer. 


One Volume Control Block (VCB) exists for each mounted volume 
in the system. The VCB maintains volume-dependent control 
information. It contains pointers to the File Control Block 
(FCB) and Window Block (WB), which control access to the 
volume's index file. (The index file is a file of file 
headers.) The WB for the index file serves the same function 
as the WB for a user file. All unigue FCBs for a volume form 
a linked list emanating from the index file FCB. This 
linkage helps to keep file access times short. Further, 
because the window that contains the mapping pointers is 
variable in length, you can increase file access speed by 
adding more access pointers to whatever extent the 
application requires. However, greater speed requires more 
main memory. 


CONTROL BLOCK OFFSET DEFINITIONS 


8.4.1 Asynchronous System Trap Control Block (ASTCB) 


Defined by: .MACRO PKTDF$,L,B,SYSDEF 


Some positional dependencies between the DCB and the AST control block 
are relied upon in the routine $FINXT in the module SYSXT. 
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»ASECT 
-™177774 
A.KSR5:'L' .BLKW 
A.DQSR:'L' .BLKW 

- BLKW 
A.CBL:'L' - BLKW 
A.BYT:'L' - BLKW 
A.AST: 'L' - BLKW 
A.NPR:'L' » BLKW 
A.PRM: 'L' » BLKW 


;Subroutine KISAR5 bias (A.CBL=0) 

;Degueue subroutine address (A.CBL=0) 

7;AST gueue thread word 

;Length of control block in bytes 

sNumber of bytes to allocate on task stack 
;AST trap address 

sNumber of AST parameters 

;Fircst AST parameter 


eee eee 


8.4.1.1 I/O Packet Offset Definitions - QIO directive processing 
constructs the 18-word I/O packet and places it in the driver I/0 
gueue. A call to S$GTPKT subsequently delivers the packet to the 
driver. 


I.LNK:'L' ~BLKW 1 71/0 queue thread word 
Links I/O packets queued for a driver. A 
0 ends the chain. The listhead is in the 
SCB (S.LHD). 
I.PRI:'L' -BLKB 1 ;Reguest priority 
Priority copied from the TCB of the re- 
guesting task. 
I.EFN:'L' »BLKB 1 sEvent flag number 
Contains the event flag number as copied 
by QIO directive processing from the reques- 


tor's DPB. 
I.TCB:'L' -BLKW 1 *TCB address of the requesting task 
I.LN2:'L' ~BLKW 1 ?Pointer to second LUN word 


Contains the address of the second word of 
the LUT entry in the task header to which 
the I/O request is directed. For open 
files on file-structured devices, this word 
contains the address of the window block, 
otherwise it is 0. 


I.UCB: 'L' ~BLKW 1 Pointer to unit control block that 
contains the address of the redirect UCB 
if the starting UCB has been subject to a 
Redirect command. 


I.FCN: 'L' ~BLKW 1 31/0 function code 
Contains the function code for the I/O 
reguest. 
I.IOSB:'L' .BLKW l Virtual address of I/O status block 
~BLKW 1 71/0 status block relocaton bias 
~BLKW 1 71/0 status block address 


I.IOSB contains the virtual address of the 
I/O status block (IOSB) if one is specified 
or 0 if one is not. 

I.IOSB+2 and I.IOSB+4 contain the address 
doubleword for the IOSB. In an unmapped 
system, the first word is 0 and the se- 
cond word is -the real address of the IOSB. 
In a mapped system, the first word contains 
the relocation bias of the IOSB; the bias is 
the 32-word block number in which the IOSB 
starts. This block number is derived by 
viewing available real memory as a col- 
lection of 32-word blocks numbered consecu- 
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tively, starting with 0. Thus, if the 
IOSB starts at physical location 3210(8), 
its block number is 32(8). See the RSX-11M 


Guide to Writing an I/O Driver for more 
etaiis. 


I.AST: 'L' ~BLKW 1 ;AST service routine address 
Contains the virtual address of the AST 
service. routine to be executed at I/O com- 
pletion. If no address is specified, the 
field contains 0. 
I.PRM: 'L' ~BLKW 1 ;Reserved for mapping parameter #1 
«BLKW 6 ;Parameters 1 to 6 constructed from the last 
6 words of the DPB. Note that if the 1/0 
function is a transfer, the buffer address 
(the first DPB device-dependent paramenter) 
is translated to an equivalent address 
doubleword. Therefore, device-dependent 
paramenter "n" is copied to I.PRM+(2*n)+2. 
»BLKW 1 sUser mode diagnostic parameter word 
I.ATTL='B'. :Minimum length of I/O packet (used by 
file system to calculate maximum 
number of attributes) 
I.LGTH='B'. ;Length of I/O request control block 


8.4.2 Clock Queue Control Block (CQCB) 

Defined by: .MACRO CLKDFS,L,B 

There are five types of clock queue control blocks. Each control block 
has the same format in the first five words and differs in the 


remaining three. 


The following control block types are defined: 


C.MRKT='B'0O ;Mark time request 

C.SCHD#='B'2 ;Task request with periodic rescheduling 

C.SSHT='B'4 ;Single shot task request 

C.SYST='B'6 :Single shot internal system subroutine 
(ident) 

C.SYTK='B'8. 7Single shot internal system subroutine (task) 

C.CSTP='B'l10. ;Clear stop bit (conditionalized on shuffling) 


8.4.2.1 Clock Queue Control Block Independent Offsets 


-ASECT 
-=0 
C.LNK:'L' ~BLKW 1 :Clock queve thread word 
C.RQT: 'L' ~BLKB 1 ;Reguest type 
C.EFN: 'L' ~BLKB 1 :Event flag number (mark time only) 
C.TCB:'L' ~BLKW 1 :;TCB address or system subroutine 

; identification 

C.TIM: 'L' -BLKW 2. ;Absolute time when request comes due 
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8.4.2.2 Clock Queue Control Block - Mark Time Dependent Offsets 


-™C.TIM+4 ;Start of dependent area 

C.AST: 'L' ~BLKW 1 ;AST address 

C.SRC:'L' -BLKW 1 7Flag mask word for 'BIS' source 
C.DST:'L' »BLKW 1 ;Address of 'BIS' destination 


8.4.2.3 Clock Queue Control Block - Periodic Rescheduling Dependent Offsets 


-=C.TIM+4 ?;Start of dependent area 
C.RSI:'L' -BLKW 2 sReschedule interval in clock ticks 
C.UIC: 'L' ~BLKW 1 7Scheduling UIC 


8.4.2.4 Clock Queue Control Block - Single-Shot Dependent Offsets 
~=C.TIM+4 ;Start of dependent area 


»~BLKW 2 7;Two unused words 
~BLKW 1 ?;Scheduling UIC 


8.4.2.5 Clock Queue Control Block - Single-Shot Internal Subroutine Offsets 
There are two type codes for this type of request: 


Type 6: single shot internal subroutine with a 16-bit value as an 
identifier. 


Type 8: single shot internal subroutine with a TCB address as an 
identifier. 


~=C.TIM+4 ;Start of dependent area 

C.SUB:'L' »-BLKW 1 ;Subroutine address 

C.AR5:'L' .BLKW 1 ?Relocation base (for loadable drivers) 
-BLKW 1 7;One unused word 


C.LGTH='B'. ;Length of clock gueue control block 


8.4.3 Communications Control Block (CCB) 
Defined by: .MACRO CUCDFS X,Y 


»ASECT 
~2U0 .CW2+2 7Position ACU at U.CW3 position 
U.ACUR: 'X »~BLKW 1 ;ACU register address (at U.CW3) 
U.NSYN: 'X -BLKB 1 ;Number of syncs to issue 
U.NSYC: 'X -BLKB 1 ;Number of syncs issued 
-=U.VCB+2 ;Extend after VCB address 
U.PHDR: 'X ~BLKW 1 ;End-of-transmit header check routine 
U.RCHK: 'X -BLKW 1 ;Address of redundancy check routine 
U.QSYN: 'X 7DQ sync buffer 
U.RCAC: 'X -BLKW 1 ;Redundancy check accumulator 
U.RBUF: 'X ~BLKW 2 ;Receive buffer address 
U.RCNT: 'X -BLKW 1 ;Receive buffer count 
U.SVC:'X ~BLKW 1 rExternal receive interrupt service 
U.TXCT: 'X 7DQ transmit buffer count 
U.INTP: 'X -BLKW 1 sInternal receive interrupt service 
U.SYNC: 'X ~BLKB 1 ;Current sync character 
U.MPN:'X ~BLKB 1 *Multipoint node number 
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U.RFRK: 'X ~BLKW 1 ;Receive fork block 
U.RFPC: 'X ~BLKW 1 7Fork PC 
U.RFR5:'X © .BLKW 1 ;Fork save R5 
U.RFR4:'X ~BLKW 1 :Fork save R4 
U.RFCT2'Y U.TXCT+1 ;DQ receive fork count 
-PSECT 
U2.HDX='Y 100000 ?Set if running half duplex 
U2.LIN='Y -40000 . ;Set if physical link half duplex 
U2.CTS='Y 20000 :Set if clear to send expected 
U2.SWC='Y 10000 7Set if switched circuit 
U2 .ONL='Y 4000 7Set if unit on line 
U2.HPT='Y 1000 *Set if DQ has protocol option 
U2.HRC='Y 400 ;Set if controller does CRC 
U2.RCV='Y 200 *Set if receiver active, half duplex 
U2.ACU='Y 100 2Set if unit has ACU © 
U2.MPT='Y 40 #Set if operating multipoint 
U2.FTM='Y 20 ;Set if just initiated receive 
U2.SFL='Y 10 :;Sent final on last message 
U2.RFK='Y 4 ;Clear when primary fork free (DQ) 
U2.SYC='Y 3 *Bits used for receiver sync count 
U2 .TXA='Y 2 ;Set if TX code active (DQ) 
U2.SNC2'Y 1 ;Set if sending syncs (DQ) 
US .SYN='Y 1 #Set if device always sends sync 
U3.LOK='Y 100000 :Software interrupt lockout (DA) 
U3.RPD='Y 400 :Set when receive pending (DA) 
U3.RAC#'Y 200 *Set when receive in progress (DA) 
U3.SND='Y 1 *Set when in transmit mode (DA) 
«MACRO CUCDFS A,B 
~ENDM 
~ENDM 


8.4.3.1 Communications Vector 


Defined by: .MACRO CVCDFS X,Y 


~ASECT 
~=V.IFWI ;Overlay from here on 
V.CPRT: 'X -BLKW 1 ;Protocol descriptor vector address 
V.CLUN: 'X -BLKB 1 sCCP'S current LUN for this node 
V.CMPN: 'X ~BLKB 1 ;Multipoint node designator 
V.CSTS: 'X -BLKW 1 :Protocol-oriented status 
V.CST1:'X -BLKB 1 Status extension 
V.CNID: 'X ~BLKB 1 ;Node ID number for next node over 
V.CUCB: 'X ~BLKW 1 sCurrent UCB for this VCB 
V.CMPL: 'X ~BLKW 1 ;Multipoint table link word 
V.CNPN: 'X ~BLKW 1 sNext multipoint node in chain 
V.CMBC: 'X ~BLKW 1 ;Multipoint half duplex count of bytes 
V.CRED: 'X ~BLKW 1 ;Redundancy check keyword 
V.CNHD: 'X -BLKW 1 sAddress of (new) header block 
V.CTBL: 'X -BLKW 1 sAddress of current AST block 
V.CRBL: 'X -BLKW 1 sAddress of current data block 
V.NXHD: 'X ~-BLKW 1 sNext header buffer address 
V.CDBC: 'X »BLKW 1 ;Receiver data count, bytes 
V.CIAD: 'X ~-BLKW 1 :Receive buffer address, enter transparency 
V.CICT: 'X »-BLKW 1 ;Receive data count, enter T. 
V.CSAD: 'X -BLKW 1 ;Receive buffer address, exit T. 
V.CSCT: 'X -BLKW 1 ;Receive buffer count, exit T. 
V.CMXI: 'X ~BLKW 1 :Max record size accepted, bytes 
V.CMXO: 'X »~BLKW 1 *Max record size can transmit 
V.CTDH: 'X »-BLKW 1 *Transmit data packet list head 


“V.CTDT: 'X 
V.CSTQ: 'X 
V.CLMT: 'X 
V.CTMA: 'X 
V.CLMR: 'X 
V.CRMA: 'X 
V.CMCT: 'X 
V.CRPC: 'X 
V.CRPL:'X 
V.CRIM: 'X 
V.CREP: 'X 
V.CBCC: 'X 
V.CDCC: 'X 
V.CURH: 'X 
V.CDLE: 'X 
V.COVR: 'X 
V.CRST: 'X 
V.CALF: 'X 
V.CREA: 'X 


V.CTPN: 'X 


V.CLEN: 'X 


-PSECT 


VS.SEL='Y 
VS.FIN='Y 
VS.REP='Y 
VS.RTR2='Y 
VS.STK='Y 
VS.STR='Y 
VS.ACK='Y 
VS.NAK='Y 
VS.MPT='Y 
VS.DIS='Y 
VS.CTL='Y 
VS.DAT='Y 
VS.SYN#'Y 
VS.POL='Y 
VS.ONL2'Y 
VS.BOO='Y 
VS.TRN='Y 


8.4.4 


Defined by: 


The Device Control Block (DCB) describes’ the 
(rather than execution-time information) of both the device controller 
and the units attached to the controller. 


- BLKW 
- BLKW 
-BLKB 
- BLKB 
-BLKB 
- BLKB 
- BLKW 
- BLKB 
- BLKB 
- BLKW 
- BLKW 
- BLKW 
» BLKW 
- BLKW 
- BLKW 
- BLKW 
- BLKW 
- BLKW 
-BLKB 
- BLKB 


PR RP RPE HE HRP RP HERP PN PPP e Nie 
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:Transmit data packet list tail 
7Start mode pre-transmission queue 
;Last message number transmitted 
;Last transmitted message ACKed 
;Last message number received 
;Last received message ACKed 
Count of messages sent 
;Consecutive rep count 
;Consecutive rep limit 

;Rep timeout value, ticks 

;Rep count accumulator 

sHeader block check error count 
;Data block check error count 
;Unrecognized header error count 
;Data late error count 
?Transmitter overrun count 

sNumber of starts or restarts 
;Number of system buffer allocation failures 
:Contains NAK reason 

;Unused 


~IF DF CSSACU 
-BLKB 12. ;Telephone number, this unit (ASCII) 


» ENDC 


~BLKW 1 


100000 
40000 
20000 
10000 

4000 
2000 
1000 

400 


:;Communications VCB length 


7;Set if select other unit 

7Set if final transmission 

;Unit in REP mode 

;Transmitter in retry mode 

7;Set if start ACK expected 

;Start mode if set 

7;Set if should send ACK 

7;Set if should send NAK 

7Set if link is multipoint 
7(V.CST1) Set link in dismount mode 
;Set if have mastership, multipoint 
;Set if data message 

;Set if sync train reguired 

7;Poll next multipoint if set 
;Related node is active 

;Marked as boot channel 

;Marked as DDCMP-only channel 


-MACRO CVCDF$ A,B 


» ENDM 
- ENDM 


is established in 


structure. 
the Executive, 


The DCB is used by the QIO directive 
rather 


link word is D.LNK. 


Device Control Block (DCB) 


«MACRO DCBDFS,L,B 


static 


assembly source for the 
processing code 


than by the driver. 


characteristics 


Most of the data in the DCB 
I/O driver data 


All the DCBs in a system 


form a forward-linked list, with the last DCB having a link of 0. The 
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At least one DCB exists for each type of device appearing in a system 
(device type should not be equated with device-unit). Therefore, a 
DCB has the device name in it; for example, the DCB for DKO: has 
"ASCII /DK/" in it. In general, there is only one DCB containing the 
name of a given device. However, in the case of the terminal driver, 
a separate DCB exists for every kind of terminal device controller in 
the system (DL, DJ, DH, and DZ), and each DCB contains ".ASCII /TT/". 
For example, if there are terminals in a system, then there is at 
least one controller and one DCB containing the device name "TT". If 
some of the terminals were interfaced via DL11-As and the rest via a 
DH11, then there would be two DCBs; one for all DL11-A-interfaced 
terminals, and one for all DHll-interfaced terminals. They both would 
contain the device name, "TT". 


P -ASECT 

D.LNK:'L' ~BLKW 1 ;Link to next DCB. A 0 in this field in- 
dicates the last (or only) DCB in the chain. 
The driver links its DCB into the system 
DCBs via the global label S$USRTB on its 
first DCB. 

D.UCB:'L' ~BLKW 1 ;Pointer to first Unit Control Block. All 
UCBs, for a given DCB, are in contiquous 
memory locations and must all be the same 
length. 

D.NAM: 'L' -BLKW 1 Generic device name in ASCII by which 
device units are referenced mnemonically. 

D.UNIT: 'L' ~BLKB 1 s;Lowest unit number covered by this DCB. 

~BLKB 1 ;Highest unit number covered by this DCB. 
These two bytes represent the range of 
logical units available to the user for 
assignment. Typically, the lowest number is 
0 and the highest is n-l, where n is the 
number of device-units described by the DCB. 

D.UCBL: 'L' ~BLKW 1 ;Length of each unit control block in 
bytes. The UCB can have any length to meet 
the needs of the driver for variable 
storage. However, all UCBs for a given DCB 
must have the same length. The specified 
length must include prefix words (U.LUIC and 
U.OWN) if present. 


D.DSP:'1' ~BLKW 1 ;Pointer to driver dispatch table. 
When the Executive must enter the driver 
at any of the four entry points contained 
in the driver dispatch table, it accesses 
D.DSP, locates the address in the table, and 
calls the driver at that address. A 0 
table address indicates that the (loadable) 
driver is not in memory. If a driver does 
not process a given function, it supplies a 
return address. For more details see the 


RSX-11M Guide to Writing an I/O Driver. 
;Legal function mask codes 0-15. 


D.MSK:'l1' »~BLKW 1 
~BLKW 1 ?Control function mask codes 0-15. 
~-BLKW 1 ;NOP'ed function mask codes 0-15. 
~BLKW 1 s;ACP function mask codes 0-15. 
»BLKW 1 ;Legal function mask codes 16.-31. 
~-BLKW 1 ;Control function mask codes 16.-31. 
~BLKW 1 sNOP'ed function mask codes 16.-31l. 
»~BLKW 1 *ACP function mask codes 16.-31. 


The Executive uses these words to validate 
and dispatch the I/O reguest specified 
by a QIO directive. 
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-BLKW 1 


sAddress of the driver's Partition Control 
Block (PCB). This word is present in 
the DCB only if the loadable-driver 
SYSGEN option has been selected. It mus 
be initialized to 0. The DCB can be 
extended by adding words after D.PCB. 
A PCB exists for every partition in a 
system. MCR creates a PCB when the SET 


/MAIN or SET /SUB commands are given. If a 


driver is loadable, its PCB describes the 
partition in which it resides. 

The Executive uses D.PCB together with 
D.DSP (the address of the driver dispatch 
table) to determine whether a driver is 
loadable or resident, and, if loadable, 
whether or not it is in memory. For more 


details see the RSX-11M Guide to Writing an 


I/O Driver. 


8.4.4.1 Driver Dispatch Table Offsets 


D.VINI='B'O 
D.VCAN='B'2 
D.VOUT='B'4 
D.VPWF='B'6 


;Device initiator 

sCancel current I/O function 
»Device timeout 

:Powerfail recovery 


8.4.5 Error Message Block (EMB) 


Defined by: .MACRO EMBDFS,L,B 


The following error codes are defined: 


EC.INI='B'40 
EC.DVC='B'l 
EC.DTO='B'140 
EC.NST='B'141 
EC.LOA='B'4 
EC.UNL='B'10 
EC.MPE='B'2 
EC.PWR='B'42 


;Device error bit set 
;Device interrupt timeout 
;Undefined interrupts 
;Driver load 

;Driver unload 

;Memory parity error 
;Power fail 


8.4.5.1 Error Message Block Independent Offsets 


eASECT 
-=0 
E.SIZE:'L' 
E.CODE: 'L' 


E.TIME: 'L' 
E.SEQ:'L' 
E.ABM: 'L' 


- BLKW 
- BLKB 
- BLKB 
- BLKB 
- BLKW 
» BLKW 


ee 


:Size of the EMB in bytes 
;Error code 

;Reserved 

:Time of error-s,m,h,d,m,y 
sSequence number 

:Saved I/O active bitmap 
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8.4.5.2 Error Message Block - Undefined Interrupt Offsets 


»"E.ABM+2 

E.VCTR:'L' ~BLKB 1 7ID of vector trapped through 
E.LOST: 'L' ~BLKB 1 sNumber of lost undefined interrupts 
E.OPS:'L' ~BLKW 1 301d PS preinterrupt 

E.OPC:'L' ~BLKW 1 ;O0ld PC preinterrupt 


8.4.5.3 Error Message Block - Device Errors and Device Interrupt 
Timeout Offsets 


-=E .ABM+2 
E.RTRY: 'L' »BLKB 2 ;Low byte=left, hi byte=start 
~BLKB 1 ;Task priority 
E.r10c:'L' ~BLKB 1 31/0 in progress count 
E.TASK:'L' »~BLKW 2 ;Task name 
E.PAR: 'L' -BLKW 1 ;Partition address 
E.UIC:'L' ~BLKW 1 Task UIC 
E.UCB:'L' ~BLKW 1 :;Device UCB address 
E.FCN:'L' ~BLKB 2 7QIO function code 
E.PRM: 'L' ~BLKW 1 ;Buffer mapping 
~-BLKW 6 sParameters 1-6 
E.RCNT: 'L' -BLKB 1 sNumber of device registers 
ie »BLKB 1 ; Reserved 
E.REGS='B"'. 
E.LGTH='B'. 


8.4.5.4 Error Message Block - Driver Load and Unload 


~*E.TIME+<9. *2> 

E.WHY: 'L' ~BLKW 1 :Action code (load/unload) 
~=,+2 

E.NAME: 'L' ~BLKW 1 Device name (ASCII) 


8.4.6 File Control Block (FCB) 


-ASECT 
-=0 
F.LINK: »~BLKW 1 ;FCB chain pointer 
F.FNUM: ~BLKW 1 ;File number 
F.FSEQ: -BLKW 1 ;File sequence number 
-BLKB 1 ;Not used 
F.FSQN: -BLKB 1 ;File segment number 
F.FOWN: ~BLKW 1 ;File owner's UIC 
F.FPRO: ~-BLKW 1 ;File protection code 
F.UCHA: »BLKB 1 ;User controlled characteristics 
F.SCHA: -BLKB 1 ;System controlled characteristics 
F.HDLB: »~BLKW 2 File header logical block number 
F.LBN: ~BLKW 2 ;LBN of virtual block 1 if contiguous 
70 if non contiguous 
F.SIZE: »BLKW 2 7;Size of file in blocks 
F.NACS: ~-BLKB 1 7;No. of accesses 
F.NLCK: ~BLKB 1 7;No. Of locks 
F.STAT: :;FCB status word 
F.NWAC: -BLKB 1 ;Number of write accessors 
»BLKB 1 ;Status bits for FCB consisting of 
FC.WAC=100000 Set if file accessed for write 
FC.DIR=40000 ;Set if FCB is in directory LRU 
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FC.CEF=20000 :Set if directory EOF needs updating 
FC.FCO=10000 ;Set. if trying to force directory contig 
F.DREF: ~BLKW 1 ;Directory EOF block number 
F.DRNM: ~BLKW 1 zlst word of directory name 
F.FEXT: »BLKW 1 ;Pointer to extension FCB 
F.FVBN: ~BLKW 2 ?Starting VBN of this file segment 
F.LKL: -BLKW 1 :Pointer to locked block list for file 
F.LGTH: :Size in bytes of FCB 
8.4.6.1 Window 
»ASECT 
-=0 
W.CTL: ~BLKW 1 ;Low byte = # of map entries active 
;High byte consists of the following bits 
WI .RDV=400 : Read virtual block allowed if set 
WI .WRV=1000 ; Write virtual block allowed if set 
WI.EXT=2000 ; Extend allowed if set 
WI .LCK=4000 ; Set if locked against shared access 
WI .DLK=10000 : Set if deaccess lock enabled 
WI .EXL=40000 ; Set if manual unlock desired 
WI .BPS=100000 ; Bypass access interlock if set 
W.VBN: ~BLKB 1 ;High byte of lst VBN mapped by window 
W.WISZ: -BLKB 1 ;Size in rtrv ptrs of window (7 bits) 
~BLKW 1 ;Low order word of lst VBN mapped 
W.FCB: »BLKW 1 :File control block address 
W.LKL: ~BLKW 1 ;Pointer to list of users locked blocks 
W.RTRV: ;Offset to lst retrieval pointer in window 
8.4.6.2 Locked Block List Node 
~ASECT 
.=0 
L.LNK: -BLKW 1 :;Link to next node in list 
L.WI1: -BLKW 1 sPointer to window for first entry 
L.VB1: -BLKB 1 :High order VBN byte 
L.CNT: -BLKB 1 7;Count for entry 
-BLKW 1 
L.LGTH: 
8.4.7 Get Command Line Control Block (GCML) 


Defined by: .~MACRO GCMLS$D GBL 


G.ERR = S.FDB ;Error return code byte 


G.MODE 
G.PSDS 
G.CMLD 
G.ISIZ 


G.DPRM 
G.SIZE 


G.ERR+1 
G.ERR+2 
G.ERR+6 
16. 


G.ERR+tG.ISIZ 


G.DPRM+6+S.FNB 


s;Status and mode control byte 
;Prompt string descriptor 

:Command line descriptor 

;Size of impure area (PTRS, FLAGS, 
; COUNTS, etc.) 

>Default prompt string 

;Buffer size 


G.MODE BIT DEFINITIONS 


GE.COM = l 
GE.IND = 2 
GE.CLO = 4 
GE.LC = 10 
GE.CON = 20 
GE.SIZ = 40 


G.ERR VALUES 


GE.IOR = -1 
GE.OPR = <2 
GE.BIF = =3 
GE.MDE = -4 
GE.EOF = -10. 
GE.RBG = -40. 
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;Comment recognition 

Indirect file recognition 

sClose command file before return 
:Pass lower case characters 
Continuation lines allowed 
;Buffer size 


3I1/O error 

s;Unable to open indirect file 

:Bad indirect file name 

;Maximum indirect file depth exceeded 
sEnd of file 

sBuffer size error (overflow) 


8.4.8 Hardware Definitions 


Defined by: .MACRO HWDDFS,L,B 


8.4.8.1 Hardware Register Addresses and Status Codes 


MPCSR='B'177746 
MPAR='B'172100 
PIRQ='B'177772 
PRO='B'O 
PR1='B'40 
PR4='B' 200 
PR5='B'240 
PR6='B'300 
PR7='B'340 
PS='B'177776 
SWR='B'177570 
TPS="B'177564 


;Address of PDP-11/70 memory parity register 
;Address of first memory parity register 
;Programmed interrupt reguest register 
;Processor priority 9 

;Processor priority 1 

;Processor priority 4 

;Processor priority 5 

;Processor priority 6 

;Processor priority 7 

;Processor status word 

;Console switch and display register 
;Console terminal printer and status register 


8.4.8.2 Extended Arithmetic Element Registers 


-IF DF ESSEAE 


AC='B'177302 
MQ='B'177304 
SC='B'177310 


» ENDC 


:Accumulator 
;Multiplier-quotient 
sShift count 


8.4.8.3 Memory Management Hardware Register and Status Codes 


-IF DF MSSMGE 


KDSARO='B'172360 
KDSDRO='B'172320 
KISARO='B‘'172340 
KISAR5='B'172352 
KISAR6='B'172354 
KISAR7='B'172356 
KISDRO='B'172300 
KISDR6='B'172314 


;Kernel D PAR 0 
sKernel D PDR 0 
:Kernel I PAR 0 
;Kernel I PAR 5 
sKernel I PAR 6 
sKernel I PAR 7 
:;Kernel I PDR 0 
*Kernel I PDR 6 
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KISDR7='B‘'172316 ;Kernel I PAR 7 
SISDRO='B'172200 ;Supervisor I PDR 0 
UDSARO='B'177660 sUser D PAR 0 
UDSDRO#='B'177620 :User D PDR 0 
UISARO='B'177640 ;User I PAR 0 
UISAR4='B'177650 sUser I PAR 4 
UISAR5='B'177652 sUser I PAR 5 
UISAR6='B‘'177654 _ 3User I PAR 6 
UISAR7='B'177656 ;User I PAR 7 
UISDRO='B ‘177600 s;User I PDR 0 
UISDR4='B'177610 sUser I PDR 4 
UISDR5='B'177612 ;User I PDR 5 
UISDR6='B'177614 ;User I PDR 6 
UISDR7='B'177616 sUser I PDR 7 
UBMPR='B'170200 ;UNIBUS mapping register 0 
CMODE='B'140000 Current mode field of PS word 
PMODE='B' 30000 Previous mode field of PS word 
SRO='B'177572 ;Segment status register 0 
SR3='B'172516 ;Segment status register 3 

- ENDC 


8.4.8.4 Feature Symbol Definitions 


FE.EXT='B'1 311/70 extended memory support 
FE.MUP='B‘'2 ;Multi-user protection support 
FE.EXV='B'4 ;Executive is supported to 20K 
FE .DRV='B'10 - ¢Loadable driver support 
FE.PLA='B'20 | ;PLAS support 
FE.CAL='B'40 ;Dynamic checkpoint space allocation 
FE.PKT='B'100 ;Preallocation of I/O packets 
PE .EXP='B'200 ;Extend Task directive supported 
FE.LSI='B' 400 ;Processor is an LSI-11l 
FE .CEX='B'20000 ;COM exec is loaded 
FE .MXT='B'40000 ;MCR exit after each command mode 
FE.NLG='B'100000 ;Logins disabled - multi-user support 
- ENDM 
~ENDM 


8.4.9 Interrupt Transfer Block (ITB) 
Defined by: .MACRO ITBDFS IL,B,SYSDEF 


-IF DF ASSTRP 
»-MCALL PKTDFS 


PKTDFS :Define AST block offsets 
~ENDC 
-ASECT 
-=0 
X.LNK:'L' ~BLKW 1 :;Link word for ITB lists starting in TCB 
X.JSR: 'L' JSR R5,@#0 ;Call SINTSC 
X.PSW: 'L' -BLKB 1 ;Low byte of PSW for ISR 
-BLKB 1 ;Unused 
X.ISR:'L' ~BLKW 1 7;ISR entry point (APR5 mapping) 
X.FORK: 'L' sFork block 
-BLKW 1 :Thread word 
~-BLKW 1 :;Fork PC 
~BLKW 1 3;Saved R5 
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-BLKW 1 s;Saved R4 
~IF DF MSSMGE 


X.REL: 'L' ~-BLKW 1 sRelocation base for APRS 
~ENDC 

X.DSI:'L' ~BLKW 1 sAddress of DIS.INT. routine 

X.TCB:'L' »BLKW 1 :TCB address of owning task 


~IF NB SYSDEF 
e1F DF ASSTRP 
~BLKW 1 3A.DQSR for AST block 


X.AST:'1' -BLKB A.PRM ;AST block 

~ENDC 
X.VEC: 'L' ~BLKW 1 ;Vector address (if AST support, 

; this is first and only AST parameter) 

X.VPC:'L' »BLKW 1 ;Saved vector PC 
X.LEN:'L' ;Length in bytes of ITB 

«ENDC 

»PSECT 


8.4.10 Logical Assignment Control Block 
Defined by: .MACRO LCBDFS,L,B 


The logical assignment control block (LCB) associates a logical 
name with a physical device-unit. LCBs are linked together to 
form the logical assignments of a system. Assignments may be on 
a system-wide or local (terminal) basis. 


»ASECT 

20 
L.LNK:'L' ~BLKW 1 ;Link to next LCB 
L.NAM: 'L' ~BLKW 1 ;Logical name of device 
L.UNIT: 'L' -BLKB 1 ;Logical unit number 
L.TYPE:'L' -BLKB 1 ;Type of entry (0=system wide) 
L.UCB:'L' »BLKW 1 7TI UCB address 
L.ASG: 'L' ~BLKW 1 ;Assignment UCB address 
L.LGTH='B'.-L.LNK s;Length of LCB 

~PSECT 


8.4.11 Partition Control Block (PCB) 
Defined by: .MACRO PCBDFS L,B,SYSDEF 
~ASECT 


P.LNK:'L' ~BLKW 1 ;Link to next PCB. The PCBs are linked in 
physical address order, highest to lowest. 

If a main partition has subpartitions, they 
are linked in the PCB chain off the main 
partition in highest to lowest address 
order. The last subpartition of a main 
partition either ends the PCB chain or 
links to the next main partition. A main 
partition with no subpartition either links 
to the next main partition or ends the 
chain. 

P.PRI:'L' -BLKB 1 ;Priority of partition 

P.I0c:'L' -BLKB 1 71/0 + I/O status block count 

P.NAM: 'L' »-BLKW 2 :Partition name in RAD50 
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P.SUB: 'L' ~BLKW 1 ;Pointer to next subpartition. Structured and 
used similarly to P.LNK when manipulating a 
chain of subpartition PCBs. 


P.MAIN: 'L' ~BLKW 1 ;Pointer to main partition. The backpointer 
from a subpartition to its parent main par- 
tition. 


-IF NB SYSDEF 
~IF NDF MSSMGE 


P.HDR: 'L' . Pointer to task header (unmapped system) 
«ENDC 
 LFTF 

P.REL: 'L' -BLKW 1 ;Starting physical address of the partition. 


The partition base relocation bias. Ina 
mapped system, P.REL is the bias; in an un- 
Mapped system, P.REL is the actual parti- 
tion address. 


P.BLKS:'L' 

P.SIZE:'L' »BLKW 1 7Size of partition in bytes 

P.WAIT: 'L' ~BLKW 2 s;Partition wait gueuve listhead (2 words). A 
pointer to a list of tasks awaiting the use 
of the partition. The list is ordered by 
priority and is searched to determine which 
task should be in control of the partition. 

P.SWS2:'L' ~BLKW 1 :Partition swap size (system-controlled 
partitions only) 

P.BUSY: 'L' ~BLKB 2 ;Partition busy flags. The first byte, the 
busy status, is the inclusive OR of the 
state for the main partition and all its 
subpartitions. The second byte, the busy 
mask, contains a busy (1) or not busy (0) 
setting for the main partition and its 
seven subpartitions. 

P.OWN: 'L' 

P.TCB: 'L' ~BLKW 1 :TCB address of the task that owns the par- 
tition (owner task). 

P.STAT: 'L' ~BLKW 1 ;Partition status flags 

~LFT 
-IF DF MSSMGE 
P.HDR: 'L' ~BLKW 1 ;Pointer to task header (mapped system) 
. ENDC 
P.PRO: 'L' »BLKW 1 ;Protection word [DEWR,DEWR,DEWR,DEWR] 
P.ATT: 'L' ~BLKW 2 ;Attachment descriptor listhead 
-IF NDF PS$SLAS 

P.LGTH='B'P.PRO sLength of partition control block 

~IFF 

P.LGTH='B'. ;Length of partition control block 

~ENDC 
~lFF 
»~PSECT 


8.4.11.1 Partition Status Word Bit Definitions 


PS .OUT='B'100000 Partition is out of memory (l=yes) 
PS.CKP='B'40000 ;Partition checkpoint in progress (l=yes) 
PS.CKR='B'20000 ;Partition checkpoint is requested 

; (l=yes) 
PS.CHK='B'10000 ;Partition is not checkpointable (l=yes) 
PS.FXD='B' 4000 ;Partition is fixed (l=yes) 
PS.PER='B'2000 ;Parity error in partition (l=yes) 
PS.LIO='B‘'1000 :;Marked by shuffler for long I/O (l=yes) 
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PS .NSF='B' 400 :Partition is not shuffleable (l=yes) 
PS.COM='B'200 ;Library or common block (l=yes) 
PS.PIC='B'100 ;Position independent library or common 
; (l=*yes) 

PS .SYS='B'40 ;System controlled partition (l#yes) 
PS.DRV='B'20 ;Driver is loaded in partition (l#yes) 
PS.DEL='B'10 ;Partition should be deleted when not 

; attached (l=yes) 
PS.APR='B'7 - s:Starting APR number mask 


8.4.11.2 Attachment Descriptor Offsets 


‘ ~ASECT 

A.PCBL:'L' »BLKW 1 ;PCB attachment gueue thread word 

A.PRI:'L' ~BLKB 1 ;Priority of attached task 

A.roc:'L' »BLKB 1 7I1/O count through this descriptor 

A.TCB: 'L' ~BLKW 1 :TCB address of attached task 

A.TCBL: 'L' ~BLKW 1 :TCB attachment gueue thread word 

A.STAT: 'L' -BLKB 1 ;Status byte 

A.MPCT: 'L' -BLKB 1 ;Mapping count of task thru this 
; descriptor 

A.PCB:'L' ~BLKW 1 :PCB address of attached task 

A.LGTH='B'. ;Length of attachment descriptor 


8.4.11.3 Attachment Descriptor Status Byte Bit Definitions 


-PSECT 
AS .DEL='B'10 :Task has delete access (1l=yes) 
AS.EXT='B'4 ;Task has extend access (l=yes) 
AS .WRT='B'2 ;Task has write access (l=yes) 
AS.RED='B'1. :Task has read access (l=yes) 


~ENDC 


8.4.12 Region Definition Block (RDB) 
Defined by: .MACRO RDBDF$ GBL 


~MCALL .BLKW.,.BLK. 

-BLK. 

~-BLKW. 1,R.GID,GBL ;Region ID 

-BLKW. 1,R.GSIZ,GBL ;Size of region (32W blocks) 
»~BLKW. 2,R.GNAM,GBL ;Name of region (RAD50O) 


.BLKW. 2,R.GPAR,GBL ;Region's main partition name (RAD50) 
~.BLKW. 1,R.GSTS,GBL ;Region status word 

.-BLKW. 1,R.GPRO,GBL ;Protection code of region 

.BLKW. 0,R.GLGH,GBL ;Length of region definition block 


8.4.12.1 Region Status Word Symbols 


-IF IDN <DEFSG>,<GBL> 
-GLOBL RS.CRR,RS.UNM,RS.MDL,RS.NDL,RS.ATT,RS.NEX 
-GLOBL RS.DEL,RS.EXT,RS.WRT,RS.RED 

»ENDC 
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RS.CRR=*“0<100000> ;Regqion was successfully created 

RS .UNM="0<40000> ;One or more windows were unmapped on a 
; detach 

RS .MDL=“0<200> :Mark region for delete on last detach 

RS .NDL#“0<100> :Created region is not to be marked for 
3; detach 

RS .ATT="0<40> sAttach to created region 

RS .NEX="0<20> sCreated region is not extendable 

RS .DEL=“0<10> . gDelete access desired on attach 

RS .EXT=°0<4> sExtend access desired on attach 

RS .WRT="0<2> sWrite access desired on attach 

RS.RED=“0<1> :;Read access desired on attach 


8.4.13 Status Control Block (SCB) 


Defined by: .MACRO SCBDF$,1.,B,SYSDEF 


The SCB defines the status of a device controller. The SCB is pointed 
to by Unit Control Blocks (UCBs). One SCB exists for each device 
controller in the system. ‘This is true even if the controller handles 
more than one device-unit (as in the case of the RK11 Controller). 
However, line multiplexers such as the DH11 and DJ1l are considered to 
have one controller for each line because all lines may transfer in 
parallel. As an example, where a group of terminals may be connected 
to two controllers, a DL11-A and a DH11, each terminal interfaced via 
the DL11-A would have a SCB because each DL11-A is an independent 
interface unit. The terminals interfaced via the DH11 would also each 
have an SCB because the DH11 is a single controller but multiplexes 
many units in parallel. 


Most of the information in the SCB is dynamic, and is used by both the 
Executive and the driver. 


»ASECT 

»2177772 

S.RCNT: 'L' ~BLKB 1 ;Number of registers to copy on error 

S.ROFF:'L' -BLKB 1 2Offset to first device register 

S.BMSV: 'L' ~BLKW 1 :Saved I/O active bitmap and pointer to 
the EMB 

S.BMSK:'L' ~BLKW 1 ;Device I/O active bit mask 

S.LHD:'L' »BLKW 2 sController I/O gueue listhead. The first 
word points to the first I/O packet in the 
queue and the second word points to the 
last I/O packet in the queue. If the gueue 
is empty, the first word is 0 and the 
second word points to the first word. 

S.PRI:'L' ~BLKB 1 *Priority at which the device interrupts. 

S.VCT: 'L' -BLKB 1 ;Interrupt vector address divided by 4. 
For loadable drivers, the MCR/VMR LOA[D] 
function uses this field and the existence 
of driver symbol(s) $xxINT, $xxINP, and 
$xxOUT to initialize the device interrupt 
vector. 

S.CM:'L' ~BLKB l sCurrent timeout count. RSX-11M supports 


device timeout, which enables a driver to 
limit the time that elapses between the 
issuing of an I/O operation and its 
termination. The current timeout count (in 
seconds) is initialized by moving S.ITM 
(initial timeout count) into S.CTM. The 
Executive clock routines (in TDSCH) examine 
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the time, decrement it and, if it reaches 0, 
call the driver at its device 
timeout entry point. 

The internal clock count is kept in 
l-second increments. Thus, a time count of 
l is not precise because the internal 
clocking mechanism is operating asynchro- 
nously with driver execution. The minimum 
meaningful clock interval is 2 if you 
intend to treat timeout as a consistently 
detectable error condition. Note, if the 
count is 0, that no timeout occurs; a 0 
value is, in fact, an indication that 
timeout is not operative. The maximum 
count is 255. You are responsible for 
setting this field. Resetting occurs at 
actual timeout or within SFORK. 

S.ITM: 'L' »BLKB 1 s;Initial timeout value 

S.CON:'L' ~-BLKB 1 :Controller index. This is the controller 
number multiplied by 2. Drivers that are 
written to support more than one controller 
use this byte. S.CON may be used by the 
driver to index into a controller table 
that the driver creates and maintains 
internally. Indexing the controller table 
enables the driver to service the correct 
controller when a device causes an 
interrupt. 

S.STS:'L' ~BLKB 1 ;Controller status (O=idle, l=busy). 

This is the interlock for marking a driver 
as busy for a specific controller. It is 
tested and set by $GTPKT and reset by 
SIODON. 

S.CSR:'L' ~BLKW 1 ;Address of the control status register 
for the device controller. The driver uses 
S.CSR to initiate I/O operations and to 
access, by indexing, other registers re- 
lated to the device that are located in 
the I/O page. This address need not be a 
CSR. It may only be a member of the 
device's register set. It is accessed at 
system bootstrap time to determine if the 
interface exists on the system hosting the 
Executive. The Executive uses §.CSR to set 
the offline bit at bootstrap so that system 
software can be interchanged between systems 
without an intervening system generation. 
Otherwise, it is only accessed by the driver 
itself. 

S.PKT: 'L' ~BLKW 1 sAddress of current I/O packet established by 
SGTPKT. This field is used to retrieve the 
I/O packet address upon the completion of 
an I/O request. S.PKT is not zeroed after 
the packet is completed. 


S.FRK:'L' -BLKW 1 :Fork block link word 
-BLKW 1 3:Fork=-PC 
-BLKW 1 *Fork-R5 
»~BLKW 1 3 Fork-R4 


The four words starting at S.FRK are used 
for fork block storage when the driver es- 
tablishes itself as a fork process. Fork 
block storage preserves the state of the 
driver, which is restored when the driver 

. regains control at fork level. This area 
is used when the driver calls $FORK. 
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The fork block is 5 words long in- 
stead of 4 if two conditions are met: 
l. Loadable drivers have been selected as 
a SYSGEN option 
2. The system is a mapped system 
If these conditions are met, and the fork 
block is 5 words long, you must not use 
the fork block for any other purpose. In 
other words, your driver may not share the 
space reserved for the fork block. If it is 
shared, the loadable driver's relocation 
base will be destroyed. In addition, the 
5-word fork block should always be part of 
the SCB if the two conditions listed above 
are met. 
-IF NB SYSDEF 
eIF DF LSSDRV & MSSMGE 
-BLKW 1 ?Fock driver relocation base 


eENDC 
S.CCB:'L' ;Mixed MASSBUS channel control block 
S.MPR:'L' ~BLKW 6 711/70 extended memory UNIBUS device 
C-block. Drivers use the 6 words starting 
at S.MPR for non-processor request (NPR) 
devices attached to a PDP-11/70 with 22-bit 
addressing. 
~IFF 


»PSECT 


8.4.13.1 Status Control Block Priority Byte Condition Code Status Bit Definition 


SP .EIP='B'l ;Error in progress (l=yes) 

SP ..ENB='B'2 ;Error logging enabled (0=yes) 
SP.LOG='B'4 ;Error logging available (l=yes) 
SPARE=10 ;Spare bit 


8.4.13.2 Mapping Assignment Block (for UNIBUS Mapping Register Assignment) 


-ASECT 
-=0 
M.LNK:'L' ~BLKW 1 7;Link word 
M.UMRA:'L' ~BLKW 1 ;Address of first assigned UMR 
M.UMRN:'L' ~BLKW 1 sNumber of UMR's assigned * 4 
M.UMVL: 'L' ~BLKW 1 ;Low 16 bits mapped by lst assigned UMR 
M.UMVH: 'L' ~BLKB 1 ;High 2 bits mapped in bits 4 and 5 
M.BFVH: 'L' -BLKB 1 ;High 6 bits of physical buffer address 
M.BFVL:'L' -BLKW 1 ;Low 16 bits of physical buffer address 
M.LGTH='B'. ;Length of mapping assignment block 

~ENDC 
~PSECT 


8.4.14 Snap Block 


Defined by: .MACRO SNPDFS$ GBL 
-IF IDN <GBL>,<DEFSG> 
-GLOBL SB.CTL,SB.DEV,SB.UNT,SB.EFN,SB.ID,SB.LM1,SB.PMD 
-GLOBL SC.HDR,SC.LUN,SC.OVL,SC.STK,SC.WRD,SC.BYT 
-ENDC 


DATA AREAS AND CONTROL BLOCKS 


SB.CTL = 0 ;Control word 

SB.DEV = 2 ;Device name 

SB.UNT = 4 sDevice unit number 

SB.EFN = 6 rEvent flag number 

SB.ID = “O<10> ;Snapshot identification word 
SB.LM1 = “0<12> ;First word of address limits 
SB.PMD = “OQ<32> ?;~RAD5O /PMD.../ 

SC.HDR = 1 . 3Dump task header (including registers) 
SC.LUN = 2 ;Dump assigned LUN information 
SC.OVL = 4 ;Dump overlay structure information 
SC.STK = “O<10> ;Dump task stack 

SC.WRD = “0<20> ;Send output in word/RAD50 format 
SC.BYT = *“0<40> ?Send output in byte/ASCII format 
8.4.15 Task Abort Codes 


Defined by: .MACRO ABODFS,L,B 


NOTE: S.COAD-S.CFLT are also SST vector offsets 


S.COAD='B'0. 
S.CSGF='B'2, 
S.CBPT='B'4. 
S.CIOT='B'6, 
S.CILI='B'8, 
S.CEMT='B'10. 
S.CTRP='B'l2. 
S.CFLT='B'14, 
S.CSST='B'l6. 
S.CAST='B'18. 
S.CABO='B'20. 
S.CLRF='B'22. 
S.CCRF='B'24. 
S.IOMG='B'26. 
S.PRTY='B‘28. 


;0dd address and traps to 4 
;Segment fault 
;Break point or trace trap 
;IOT instruction 
;Illegal or reserved instruction 
;Non RSX EMT instruction 
;TRAP instruction 
711/40 floating point exception 
:SST abort ~ bad stack 
;AST abort ~ bad stack 
;ABORT via directive 
;Task load request failure 
:Task checkpoint read failure 
;Task exit with outstanding I/O 
;Task memory parity error 

-ENDM 


8.4.16 Task Control Block (TCB) And Status Definitions 


Defined by: .MACRO TCBDFS,L,B,SYSDEF 


T.LNK: 'L' »BLKW 1 ;Utility link word 

T.PRI: 'L' -BLKB 1 ;Task priority 

T.10C:'L' -BLKB 1 31/0 pending count 

T.CPCB:'L' ~BLKW 1 ;Pointer to checkpoint PCB 

T.NAM: 'L' »BLKW 2 ;Task name in RAD50 

T.RCVL:'L' »BLKW 2 ;Receive queue listhead 

T.ASTL: 'L' ~BLKW 2 ;AST gueue listhead 

T.EFLG: 'L' -BLKW 2 :Task local event flags 1-32 
T.UCB:'L' ~BLKW 1 ;UCB address for pseudo device 'TI' 
T.TCBL: 'L' -BLKW 1 *Task list thread word 

T.STAT: 'L' -BLKW 1 ;First status word (blocking bits) 
T.ST2:'L' ~BLKW 1 7Second status word (state bits) 
T.ST3:'L' ~BLKW 1 *Third status word (attribute bits) 
T.DPRI:‘L' ~BLKB 1 ?Task's default priority 

T.LBN:'L' ~BLKB 3 ;LBN of task load image 

T.LDV:'L' ~BLKW 1 ;UCB address of load device 
T.PCB:'L' »BLKW 1 :;PCB address of task partition 
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;Maximum size of task image (mapped only) 
;Address of next task in active list 


T.MXSZ:‘L' - BLKW 
T.ACTL: 'L' - BLKW 


He 


;START OF PLAS AREA 


T.ATT: 'L' ~BLKW 2 sAttachment descriptor listhead 
T.OFF:'L' ~BLKW 1 ;Offset to task image in partition 
-BLKB 1 ; Reserved 
T.SRCT:'L' ~BLKB 1 7;SREF with EFN count in all receive 
7 Queues 
T.RRFL:'L' »BLKW 2 ;Receive by reference listhead 


~-LF NB SYSDEF 
-IF NDF PSSLAS 
T.LGTH='B'T.ATT 
LFF 
T.LGTH='B‘. Length of task control block 
» ENDC 
T.EXT='B'O s;Length of TCB extension 


8.4.16.1 Task Status Definitions 


First Status Word (Blocking Bits) 


TS .EXE='B‘'100000 7Task not in execution (l=yes) 

TS.RDN="B‘' 40000 7I1/O rundown in progress (l=yes) 

TS.MSG='B'20000 ;ABORT message being displayed (l=yes) 

TS.NRP='B'10000 7Task mapped to nonresident partition 
(l=yes) 

TS.RUN='B'4000 7Task is running on another processor 
(l=yes) 

TS .OUT='B'400 ?Task is out of memory (l=yes) 

TS.CKP='B'200 ;Task is being checkpointed (l=yes) 

TS.CKR='B'100 ;Task checkpoint requested (l=yes) 


Task Blocking Status Mask 


TS.BLK='B'TS.CKP!TS.CKRITS.EXE!TS.MSG!ITS .NRP!TS.OUT!TS.RDN 


Second Status Word (State Bits) 


T2..AST='B‘'100000 ;AST in progress (l=yes) 

T2.DST='B‘' 40000 ;AST recognition disabled (l=yes) 
T2.CHK='B'20000 ;Task not checkpointable (l=yes) 
T2.CKD='B'10000 ;Checkpointing disabled (l=yes) 
T2.BFX='B'4000 ?Task being fixed in memory (l=yes) 
T2.FXD='B'2000 ;Task fixed in memory (l=yes) 
T2.TIO='B'1000 ;Task is engaged in terminal I/0 
T2.CAF='B'400 ;DYN checkpoint space allocation failure 
T2.HLT='B'200 ;Task is being halted (l=yes) 
T2.ABO='B‘'100 ;Task marked for ABORT (l=yes) 
T2.STP='B'40 7Task stopped (l=yes) 

T2.STP='B‘'20 7Task stopped (l=yes) 

T2.SPN='B'10 ;Saved TS.SPN on AST in progress 
T2.SPN='B'4 ;Task suspended (l=yes) 

T2 .WFR='B'2 ;Saved TS.WFR on AST in progress 
T2.WFR='B'1l ;Task in Wait For state (l=yes) 
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Third Status Word (Attribute Bits) 


T3 .ACP='B‘'100000 ;Ancillary control processor (l#yes) 

T3.PMD='B' 40000 ;Dump task on synchronous abort (0yes) 

T3.REM='B'20000 ;Remove task on exit (l=yes) 

T3.PRV='B'10000 *Task is privileged (l=yes) 

T3.MCR='B'4000 ;Task requested as external MCR function 
(l=yes) 

T3.SLV='B'2000 Task is a slave task (l=yes) 

T3.CLI='B‘'1000 :Task is a command line interpreter 
(l=yes) 

T3.RST='B'400 :Task is restricted (l=yes) 

T3 .NSD='B'200 :Task does not allow send data 

T3.CAL='B'100 sTask has checkpoint space in task image 

T3.ROV='B'40 :Task has resident overlays 

T3 .NET='B'20 ;Network protocol level 


8.4.17 Task Header 


Defined by: .MACRO HDRDFS$,L,B 


-ASECT 
30 
H.CSP:'L' »BLKW 1 ;Current stack pointer 
H.HDLN: 'L' -BLKW 1 sHeader length in bytes 
H.EFLM: 'L' ~BLKW 2 sEvent flag mask word and address 
H.CUIC: 'L' -BLKW 1 sCurrent task UIC 
H.DUIC: 'L' »BLKW 1 *Default task UIC 
H.IPS:'L' »BLKW 1 sInitial processor status word (PS) 
H.IPC:'L' ~BLKW 1 ;Initial program counter (PC) 
H.ISP:'L' ~BLKW 1 sInitial stack pointer (SP) 
H.ODVA: 'L' -BLKW 1 ;0DT SST vector address 
H.ODVL: 'L' »BLKW 1 ;ODT SST vector length 
H.TKVA: 'L' ~BLKW 1 :Task SST vector address 
H.TKVL: 'L' ~BLKW 1 ;Task SST vector length 
H.PFVA:'L' ~BLKW 1 *Power fail AST control block address 
H.FPVA:'L' »BLKW 1 ;Floating point AST control block address 
H.RCVA:'L' ~BLKW 1 sReceive AST control block address 
H.EFSV:'L' »BLKW 1 sEvent flag address save address 
H.FPSA:'L' »BLKW 1 :Pointer to floating point/EAE save area 
H.WND: 'L' »BLKW 1 ;Pointer to number of window blocks 
H.DSW: 'L' »BLKW 1 ;Task directive status word 
H.FCS: 'L' ~BLKW 1 ;FCS impure pointer 
H.FORT: 'L' «BLKW 1 ;FORTRAN impure pointer 
H.OVLY: 'L' »BLKW 1 ;Overlay impure pointer 
H.VEXT: 'L' ~BLKW 1 sWork area extension vector pointer 
H.SPRI:'L' ~BLKB 1 ;Priority difference for swapping 
H.NML: ‘'L' »BLKB 1 :;Network mailbox LUN 
H.RRVA: 'L' -BLKW 1 ;Receive by reference AST control block 
; address 
~BLKW 3 ;Reserved words 
H.GARD:'L' ~BLKW 1 :Pointer to header guard word 
H.NLUN: 'L' »BLKW 1 sNumber of LUNs 
H.LUN:'L' ~BLKW 2 :Start of logical unit table 


8.4.17.1 Window Block Offsets 


-=Q 
W.BPCB:'L' ~BLKW 1 sPartition control block address 
W.BLVR: 'L' ~BLKW 1 sLow virtual address limit 
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W.BHVR: 'L' -BLKW 1 ;High virtual address limit 

W.BATT: 'L' ~BLKW 1 ;Address of attachment descriptor 
W.BSIZ:'L' ~BLKW 1 ;Size of window in 32W blocks 
W.BOFF:'L' -BLKW 1 ;Physical memory offset in 32W blocks 
W.BFPD: 'L' ~BLKB 1 ;First PDR address 

W.BNPD: 'L' ~BLKB 1 ;Number of PDRs to map 

W.BLPD: 'L' ~BLKW 1 ;Contents of last PDR 

W.BLGH: 'L' sLength of window descriptor 


8.4.18 Task Image File Label Block 


8.4.18.1 Resident Library Descriptor Offsets 
Defined by: .MACRO LBLDFS,L,B 


-ASECT 
#0 
RSLNAM: 'L' »BLKW 2 ;RADIX-50. library name 
RSLSA: 'L' -BLKW 1 ;Library starting virtual address 
R$LHGV: 'L' ~BLKW 1 ;Library address window 0 bound 
RSLMXV: 'L' ~BLKW 1 ;Library high virtual address limit 
RS$LLDZ: 'L' ~BLKW 1 ;Library load size (32W blocks) 
RSLMX2Z:'L' ~BLKW 1 ;Library max. size (32W blocks) 
RSLOFF: 'L' »BLKW 1 ;Library offset into partition (32W 

3; blocks) 

RSLWND: 'L' ~BLKW 1 :Number of library address windows 
RSLSEG: 'L' ~BLKW 1 ;Size of library segment descriptors 
RSLFLG:'L' ~BLKW 1 ;Library flags word 
RSLDAT: 'L' ~BLKW 3 ;Library creation date (yr., mo., day) 
RSLSIZ:'L' »BLKW 0 s;Length of library descriptor 


8.4.18.2 Library List Entry Flags 


LDSACC='B'100000 ;Access intent (12RW, 0=RO) 
LDSRSV='B'040000 ;APR reservation flag (12APR reserved) 
LDS$ REL='B'000004 ?PIC flag (l=position independant) 


8.4.18.3 Label Block Offsets 


30 
LSBTSK: 'L' »~BLKW 2 ;RADIX 50 task name 
NOTE 
Label block parameters between this 
offset and the start of the task library 
descriptors must be identical in format 
and content to a resident library 
descriptor entry. 
LSBPAR: 'L' »BLKW 2 ;RADIX 50 partition name 
LSBSA: 'L' »BLKW 1 :Starting address of task 
LSBHGV: 'L' ~BLKW 1 ;Window 0 virtual address limit 
LSBMXV: 'L' »BLKW 1 :;Task high virtual address limit 
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LSBLD2Z:'L' ~BLKW 1 ;Task load size (32W blocks) 
LSBMXZ: 'L' ~BLKW 1 7;Task max. size (32W blocks) 
LSBOFFs: 'L' -BLKW 1 ?Task offset into partition (32W blocks) 
LSBWND:'L' -BLKW 1 ;Number of task windows (less libraries) 
LSBSEG:'L' ~BLKW 1 *Size of task segment descriptors (bytes) 
LSBFLG:'L' © .BLKW 1 *Task flags word 
LSBDAT: 'L' »BLKW 3 ;Task creation date (yr., mo., day) 
LSBLIB:’L' ~BLKW <7.*<RSLSIZ/2>>+1 ;Resident library entries 
LSBPRI: 'L' ~-BLKW 1 . ;Task priority 
LSBXFR: 'L’ ~BLKW 1 7Task transfer address 
LSBEXT: 'L' ~BLKW 1 7Task extend size (32W blocks) 
LSBSGL:'L' -BLKW 1 ;Relative block number of segment length 
: list 
LSBHRB:'L' ~BLKW 1 ;Relative block number of task image 
; header 
LSBBLK:'L' ~BLKW 1 zNumber of blocks in label 
LSBLUN: 'L' ~BLKW 1 sNumber of logical units 
»-BLKW <512.-.>/2 
LSBASG: 'L' ~BLKW 0 ;Start of device assignment tables 
TSSPIC='B'100000 7Task is PIC (l=yes) 
TSSNHD='B'040000 ;No header in task image (l=yes) 
TSSACP='B'020000 *Task is ancillary control processor (l=yes) 
TSSPMD='B'010000 ;Generate post-mortem dump (l=yes) 
TSSSLV='B'004000 7Task is slaveable (l=yes) 
TSSNSD='B'002000 ;No send to task is permitted (l=yes) 
TSSNET='B'001000 ;Task uses new network protocol (l=yes) 
TSSPRV='B'000400 ?Task is privileged (l=yes) 
TSSCMP='B'000200 ;Task built in compatibility mode (1l=yes) 
TSSCHK='B‘'000100 ;Task is checkpointable (0=yes) 
TSSRES='B'000040 ;Task has resident overlays (l=yes) 
~PSECT 


8.4.19 Task Termination Notification Message Codes 
Defined by: .MACRO ABODFS,L,B 


T.NDNR='B'0O ;Device not ready 
T.NDSE='B'2 ;Device select error 
T.NCWF="B'4 ;Checkpoint write failure 
T.NCRE='B'6 ;Card reader hardware error 
T.NDMO='B'8, ;Dismount complete 
T.NLDN='B'12. ;Link down (networks) 
T.NLUP='B'14, ;Link up (networks) 

-ENDM 


8.4.20 Unit Control Block (UCB) 
Defined by: .MACRO UCBDFS,L,B 


One UCB exists for each device-unit attached to a system. In other 
words, one UCB exists for each device-unit of each DCB. The UCB 
defines the status of an individual device-unit, and is the control 
block that is pointed to by the first word of an assigned LUN. The 
UCBs associated with a particular DCB are contiguous in memory, have 
the same length, and are pointed to by the DCB. UCBs associated with 
different DCBs may have different lengths but are of the same length 
for a specific DCB. 


Much of the information in the UCB is static, though a few dynamic 


parameters exist. From the UCB, however, it is possible to access 
most of the other structures in the I/O data base. In this sense, the 
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UCB gives access to a large amount of dynamic data. For example, the 
redirect pointer, which reflects the results of an MCR Redirect 
command, is updated dynamically. 


As with the DCB, most of the UCB is established in the assembly 
source; however, its contents are used and modified by both the 
Executive and the driver, though modification of a given datum is 
usually done by either the Executive or the driver, but not both. 
Because the UCB is the key control in the I/O data structures, access 
to other I/O control blocks usually occurs via links implanted in the 
UCB. 


»ASECT 

~7177774 

U.LUIC: 'L' ~BLKW 1 ;LOGIN UIC — for terminal UCBs on multi-user 
systems only 

U.OWN: 'L' »-BLKW 1 :The UCB address of the owning terminal for 
allocated devices - multi-user systems 
only 

U.DCB:'L' -BLKW 1 ;Back pointer to corresponding DCB 


Access to other control blocks in the I/0 
data structure usually occurs via the UCB. 

U.RED: 'L' »BLKW 1 ;Pointer to redirect unit UCB. initially 
points to U.DCB. This field is changed 
as the result of the Redirect command. 
After the command is issued, this field 
points to the UCB to which this device-unit 
has been redirected. The redirect 
chain ends when this field points to U.DCB 
field in the UCB in which it resides. 

U.CTL: ‘'L' »BLKB 1 ;Control processing flags (set at assembly 
time). U.CTL and the function mask words 
in the DCB drive QIO directive processing. 
Any inaccuracy in the bit setting of U.CTL 
produces erroneous I/O processing. See the 
RSX-11M Guide to Writing an I/O Driver for 
more details. 

U.STS: 'L' »~BLKB 1 ;Device independent unit status 

U.UNIT: 'L' ~BLKB 1 Physical unit number of device. If the 
controller for the device supports only one 
unit, the unit number is always 0. 

U.ST2:'‘L' »-BLKB 1 ;Unit status extension 


U.CW1:'L' ~BLKW 1 ;First device characteristics word 
This is the first word in a cluster of 
device characteristics information. U.CWl 
and U.CW4 are device independent. U.CW2 
and U.CW3 are device dependent. The four 
characteristic words are retrieved from the 
UCB and placed in the reguestor's buffer 
upon issuance of a GLUNS Executive direc- 
tive. It is the responsibility of the 
driver writer to supply the contents of 
these four words in the assembly source of 
the driver's data structure. See the 
RSX-11M Guide to Writing an I/O Driver. 

U.CW2:'L' ~BLKW 1 ;Secon evice characteristics word. This 
word is specific to a given device driver 
and, with an exception, is available for 
working storage or constants. The ex- 
ception is for block-structured devices. 
In this case, U.CW2 and U.CW3 may not be 
used for working storage. In drivers for 
block=structured devices (disks and 
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U.CW3:'L' 
U.CW4:'L' 
U.SCB:'L' 


U.ATT:'L' 


U.BUF:'L' 


U.CNT: 'L' 


- BLKW 
- BLKW 
- BLKW 


He 


~BLKW 1 


~BLKW 1 
~BLKW 1 


-BLKW 1 


U.VCB='B'U.CNT+4 
U.CBF='B'U.CNT+2 
U.UIC='B'U.CNT+<9.*2> 


-PSECT 
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DECtape), these two words must be 
initialized to a double-precision number 
giving the total number of blocks on the 
device. Place the high-order bits in the 
low-order byte of U.CW2 and the low-order 
bits in U.CW3. 

;Third device characteristics word 

:Fourth device characteristics word 

._ #Pointer to SCB for this UCB. In general, R4 

contains the value in this word upon entry 
to the driver via the driver dispatch table 
because service routines frequently refer- 
ence the SCB. 

sAddress of the TCB of the task attached to 
to the unit. 

:Relocation bias of current I/O request. 

*Buffer address of current I/O request. 
U.BUF labels two consecutive words that 
serve as a communication region between 
SGTPKT and the driver. If a non-transfer 
function is indicated (in D.MSK), U.BUF, 
U.BUF+2, and U.CNT receive the first three 
parameter words from the I/O packet. 

For transfer operations, the format of 
these two words depends upon the setting of 
UC.NPR in U.CTL. The driver does not format 
the words; all formatting is completed be- 
fore the driver receives control. For un- 
mapped systems, the first word is 0 and 
the second word is the physical address of 
the buffer, For mapped systems, the UC.NPR 
bit determines the format. UC.NPR is set 
for an NPR device and reset for a pro- 
gram-transfer device. 

For more information, see the RSX-11M 
Guide to Writing an I/O Driver. 

;Byte count of current I/O request 
Contains the byte count of the buffer 
described by U.BUF. The driver uses this 
field to construct the device address. 

U.BUF and U.CNT keep track of the current 
data item in the buffer for the current 
transfer (except for NPR transfers). Be- 
cause this field is being altered dyna- 
mically, the I/O packet may be needed to 
reissue an I/O operation; for instance, 
after a powerfail or error retry. 

;Address of volume control block 
;Control buffer relocation and address 
:Terminal UIC (terminals only) 


8.4.20.1 Device Table Status Definitions 


Device Characteristics Word 1 (U.CWl) Device Type Definition Bits 


DV.REC='B'l 
DV.CCL='B'2 
DV.TTY='B'4 
DV.DIR='B'10 
DV.SDI='B'20 
DV .SQD='B'40 


;Record oriented device (l=yes) 
;Carriage control device (l=yes) 
:Terminal device (l=yes) 

:File structured device (l=yes) 
;Single directory device (l=yes) 
:Seguential device (l=yes) 
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DV .MXD='B'100 
DV.UMD='B‘200 
DV .SWL='B‘'1000 
DV.ISP='B‘ 2000 
DV .OSP='B‘ 4000 
DV.PSE='B'10000 
DV.COM='B‘ 20000 


DV.F11='B' 40000 
DV .MNT='B'100000 


?MASSBUS device (l=yes) 

;User mode diagnostics supported (l=yes) 
;Unit software write locked (l=yes) 
;Input spooled device (l=yes) 

7Send output to spooled device (l=yes) 
:;Pseudo device (l=yes) 

;Device is mountable as COM channel 

; (l*yes) 

;Device is mountable as Fll device 

; (l=*yes) 

:Device is mountable (l=yes) 


Terminal Dependent Characteristics Word 2 (U.CW2) Bit Definitions 


U2.DH1='B‘'100000 
U2.DJ1='B‘' 40000 
U2.RMT='B‘'20000 
U2.L8S='B‘'10000 
U2 .NEC='B'4000 
U2.CRT='B'2000 
U2 ..ESC='B'1000 
U2.LOG='B'400 
U2.SLV='B‘'200 
U2.D21='B'100 
U2.HLD='B'40 
U2.AT.='B'20 
U2.PRV='B'10 
U2.L3S#'B'4 
U2.VT5='B'2 
U2.LWC='B'l 


;Unit is a multiplexer (l=yes) 

sUnit is a DJ11 (1l=yes) 

;Unit is remote (l=yes) 

;Unit is LA180s (l=yes) 

7Do not echo solicited input (l=yes) 
;Unit is a CRT (l=yes) 

;Unit generates escape sequences (l=yes) 
;User logged on terminal (0=yes) 

;Unit is a slave terminal (l=yes) 

;Unit is a D211 (l=yes) 

:Terminal is in hold screen mode (1l=yes) 
;MCR command AT. being processed (1l=yes) 
:Unit is a privileged terminal (l=yes) 
:Unit is a LA30S terminal (l=yes) 

;Unit is a VTO5B terminal (l=yes) 

;Lower case to upper case conversion 

; (l=yes) 


RH11-RS03/RS04 Characteristics Word 2 (U.CW2) Bit Definitions 


U2.R04='B'100000 


;Unit is a RSO04 (l=yes) 


RH11-TU16 Characteristics Word 2 (U.CW2) Bit Definitions 


U2.7CH='B‘'10000 


Unit Control Processing 


UC.ALG='B' 200 


UC.NPR='B'100 


UC.QUE='B'40 


UC. PWF='B'20 


;Unit is a 7 channel drive (l=yes) 


Flag Definitions 


;Byte alignment of data buffers is allowed 
(0=vyes) 
Word alignemnt is allowed (l=yes) 

;Device is an NPR device (l=yes) 
This word determines the format of the 
2-word address in U.BUF. 

;Call driver before queuing (l=yes) 
If set, the QIO directive processor calls 
the driver prior to gueing the I/O packet. 
The disposition of the I/O packet is the 
driver's responsibility. Typically, an I/O 
packet is queued prior to a call to the 
driver, which later retrieves it by a call 
to $GTPKT. 

;Call driver at powerfail always (l=yes) 
If set, the driver is always called when 
power is restored after a power failure 
occurs. Typically, the driver is called on 
power restoration only when an I/O opera- 
tion is in progress. 
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7Call driver on ATTACH/DETACH (l=yes) 
If this bit is set, the driver is called 
when S$GTPKT processes an Attach/Detach I/0 
function. Typically, the driver does not 
get control for Attach/Detach reguests and 
the Executive performs the entire function 
without any assistance from the driver. 

7Call driver at I/O kill always (l=yes) 

If set, the driver is called on a Cancel 
I/O request even if the specified unit is 
not busy. Typically, the driver is called 
on a Cancel I/O only if an I/O operation 
is in progress. 

:Transfer length mask bits 
These two bits are used to check 
whether the byte count specified 
in an I/O request is a legal buffer 


modulus. See Guide to Writing an 
I/O Driver manual. 


Unit Status (U.STS) Bit Defintions 


This byte contains device-independent status information. US.MDM, 
US.MNT, and US.FOR apply only to mountable devices. 


US.BSY='B'200 
US .MNT='B'100 


US.FOR='B'40 
US .MDM='B ‘20 


;Unit is busy (l=yes) 

;Unit is mounted (0=yes) 

;Unit is mounted as foreign volume (l=yes) 
;Unit is marked for dismount (l=yes) 


Card Reader Dependent Unit Status Bit Definitions 


US.ABO='B'1l 


US.MDE='B'2 


;Unit is marked for abort if not ready 
; (l=yes) 
;Unit is in 029 translation mode (l=yes) 


FILES-11 Dependent Unit Status Bits 


US .WCK='B'10 
US.SPU='B'2 


;Write check enabled (l=yes) 
;Unit is spinning up (l=yes) 


Terminal Dependent Unit Status Bit Definitions 


US.DSB='B'10 
US.CRW='B'4 
US .ECH='B'2 
US .OUT='B'l 


;Unit is disabled (l=yes) 

;Unit is waiting for carrier (l=yes) 
;Unit has echo in progress (l=yes) 
;Unit is expecting output interrupt 
; (l=yes) 


LPS1l1 Dependent Unit Status Bit Definitions 


US.FRK='B‘2 
US.SHR='B'l 


7Fork in progress (l=yes.) 
;Shareable function in progress (0=yes) 
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ANSI Magtape Dependent Unit Status Bits 


US.LAB='B'4 ;Unit has labeled tape on it (1l#=yes) 


Unit Status Extension (U.ST2) Bit Definitions 


US.OFL='B'l - 3Unit offline (l=yes) 

US.RED='B'2 ;Unit redirectable (0=yes) 

US.PUB='B'4 Unit is public device (l=yes) 

US .UMD='B'10 ;Unit attached for diagnostics (l=yes) 


8.4.21 Volume Control Block (VCB) 


eASECT 
~=0 
V.TRCT: ~BLKW 1 ;Transaction count 
V.IFWI: ~BLKW 1 ;Index file window 
V.FCB: ~BLKW 2 7;File Control Block listhead 
V.IBLB: ~BLKB 1 :;Index bit map lst LBN high byte 
V.IBS2: ~BLKB 1 ;Index bit map size in blocks 
~BLKW 1 ;Index bit map lst LBN low bits 
V.FMAX: -BLKW 1 ;Max no. of files on volume 
V.WISZ: ~BLKB 1 ;Dflt size of window in no. of rtrv ptrs 
;Value is < 128. 
V.SBCL: ~BLKB 1 sStorage bit map cluster factor 
V.SBS2: »BLKW 1 ;Storage bit map size in blocks 
V.SBLB: »BLKB 1 :Storage bit map lst LBN high byte 
V.FIEX: -BLKB 1 ;Default file extend size 
»BLKW 1 ;Storage bit map lst LBN low bits 
V.VOWN: »BLKW 1 :Volume owner's UIC 
V.VPRO: ~BLKW 1 ;Volume protection 
V.VCHA: -BLKW 1 ;Volume characteristics 
V.FPRO: ~BLKW 1 ;Volume default file protection 
V.VFSQ: ~-BLKW 1 ;Volume file sequence number 
V.FRBK: -BLKB 1 ;Number of free blocks on volume high 
byte 
V.LRUC: »BLKB 1 ;Count of available LRU slots in FCB list 
-BLKW 1 :Number of free blocks on volume low bits 
V.STAT: -BLKB 1 ;Volume status byte, containing the 
following: 
VC.IFW= 1 Index file is write accessed 
VC.BMW= 2 Storage bit map file is write accessed 
V.FFNU: ~BLKB 1 ;First free index file bit map block 
V.LGTH: ;Size in bytes of VCB 


8.4.22 Window Definition Block (WDB) 


Defined by: .MACRO WDGDFS GBL 
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8.4.22.1 Window Definition Block Offsets 


»MCALL .BLKW.,.BLKB.,.BLK. 

BLK. 

~-BLKB. 1,W.NID,GBL ;Window ID 

~BLKB. 1,W.NAPR,GBL ;Base APR 

-BLKW. 1,W.NBAS,GBL ;Virtual base address (bytes) 
~BLKW. 1,W.NSIZ,GBL ;Window size (32W blocks) 

~BLKW. 1,W.NRID,GBL- Region ID 

~-BLKW. 1,W.NOFF,GBL ;O£ffset in partition (32W blocks) 
~BLKW. 1,W.NLEN,GBL ;Length to map (32W blocks) 

~BLKW. 1,W.NSTS,GBL ;Window status word 

~-BLKW. 1,W.NSRB,GBL ;Send/receive buffer virtual address (bytes) 
~BLKW. 0O,W.NLGH,GBL s;Length of window definition block 


8.4.22.2 Window Status Word Symbols 


-IF IDN <DEFSG>,<GBL> 
-GLOBL WS.CRW,WS.UNM,WS.ELW,WS.RRF,WS.64B 
e-GLOBL WS.MAP,WS.RCX,WS.DEL,WS.EXT,WS.WRT,WS.RED 


«ENDC 

WS .CRW="0<100000> ;Address window was successfully created 

WS . UNM="0<40000> ;One or more windows were unmapped in 
;Create address window or map. 

WS ..ELW=*0<20000> ;One or more windows were eliminated in 
;Create address window 

WS .RRF="0<10000> ;Reference was successfully received 

WS .64B="0<400> 764 byte alignment allowed 

WS .MAP="0< 200> ;Map after create window or receive 
by reference 

WS .RCX#"0<100> ;Exit if no references to receive 

WS .DEL=*0<10> ;Send with delete access 

WS .EXT="0<4> 7Send with extend access 

WS .WRT="O< 2> ;Send with write access or map with 
; write access 

WS.RED="0<1> ;Send with read access 


CHAPTER 9 
CROSS-REFERENCES 


9.1 EXECUTIVE MODULE TO ROUTINE CROSS~REFERENCE 


This cross-reference contains a 
(driver 


($) 


Large and important local routines are in 
sign 


dollar 
global. 


Module 


BFCTL 


CORAL 


CRASH 


CTDRV 


preceeds 


the 


listing of the executive 


tables not included) and the routines that they contain. 
routines are in alphabetical order as are the modules. 
label of global routines. 
this cross-reference but some are the labels of data areas or fields. 


this 


Routines and Labels 


Buffer 
$BLXIO 
SGTBYT 
SGTCWD 
SGTWRD 
SPTBYT 
SPTWRD 


Core buffer allocation 


SALCLK 
SALOC1 
SALOCB 
SALPKT 
SDEAC1 
$DEACB 
SDECLK 
SDEPKT 


control routines 


~- Move block of 


~ Get 
- Get 
- Get 
- Put 
- Put 


data 

from user buffer 

from user control buffer 
from user buffer 

in user buffer 

in user buffer 


next byte 
next word 
next word 
next byte 
next word 


routines 


- Allocate clock queue core block 

- Allocate core buffer (alternate entry) 
Allocate core buffer 
Allocate SEND or I/O REQUEST core block 


- Deallocate 
- Deallocate 
- Deallocate 
- Deallocate 


core buffer (alternate entry) 
core buffer 

clock queue core block 

SEND or I/O REQUEST core block 


Crash dump routines 


$CRASH - Crash dump 


SCRSBF 
SCRSBN 
SCRSCS 
SCRSHT 
SCRSUN 
SPANIC 


routine 


- Internal crash stack 
Starting device address 
Checksum of device address 


Crash unit number (CSSRUN) stored here 


- Halt to wait for the user 


Reference entry label only 


TAl1 tape cassette controller driver 

- Controller interrupt processing 
- Controller initiator 

- Driver dispatch table 

- Spacing function 

- Read logical function 


SCTINT 
CTINI 
SCTTBL 
SPCBK 
RDBLK 


A dollar 
All named labels are in 


cross~reference. 
($) does not preceed these routines because they are not 


Module 


CTDRV 
(cont. ) 


CVRTM 


DBDRV 


DLDRV 


DMDRV 


DPDRV 


DRABO 


DRASG 


CROSS-REFERENCES 


Routines and Labels 


WRBLK 
WREOF 
CTOUT 


Write logical function 
Rewind and write EOF functions 
Device timeout 


Convert time routine 


SCVRTM - Convert a time interval-time units pair to a 


clock ticks count 


RH11-RP04/05/06 disk pack driver 


CNTBL 
RTTBL 
TEMP 
OFFAD 
OFFTB 
FUNTBL 
SDBTBL 
DBINI 


Address of current unit control block 
Retry count for current operation 
Temporary storage for controller number 
Address of current offset value 

Offset positioning value table 
Diaqnostic function table 

Driver dispatch table 

Initiator 


RL11/RL01 disk driver 


CNTBL 
RTTBL 
TEMP 
SDLTBL 
DLINI 
DLINIO 
DLOUT 
DLDIFF 
DLDVER 
DLDTER 


Address of current unit control block 
Retry count for current operation 
Temporary storage for controller number 
Driver dispatch table 

Initiator (get I/O packet) 

Initiate I/O operation 

Device timeout 

Cylinder address difference calculator 
Error logging routine 

Error logging routine 


RK611-RK06/RKO7 disk cartridge driver 


CNTBL 
RTTBL 
TEMP 
FUNTBL 
OFFTB 
SDMTBL 
DMINI 
DMINIO 
DMOUT 
DMECC 
DMECOR 
DMDVER 
DMDVTO 
DMRPAS 
DMDINT 


RP11-C/E 


CNTBL 
RTTBL 
TEMP 
FUNTBL 
$SDPTBL 
DPINI 
DPOUT 


Address off currrent unit control block 
Retry count for current operation 
Temporary storage for controller number 
Diagnostic function table 

Offset positioning data 

Driver dispatch table 

Initiator 

I/O initiator 

Device timeout 

Error correction 


Memory address calculation for correction 


Error logging 

Error logging 

Controller register pass routine 
Diagnostic interrupt handler 


disk pack controller driver 

Address of current unit control block 
Error retry count and positioning flag 
Temporary storage for controller number 
Diagnostic function code table 

Driver dispatch table 

Initiator 

Device timeout 


Abort task routine 
SDRABO - Abort a specified task 


Assign a device unit to a logical unit number 
SDRASG - Assign logical unit number (LUN) 


Module 


DRATX 


DRCIN 


DRCMT 


DRDAR 


DRDCP 


DRDSP 


DREIF 


DREXP 


DRGCL 


DRGLI 


DRGPP 


DRGSS 


DRGTK 


CROSS-REFERENCES 


Routines and Labels 


End execution of an asynchronous system trap service 
routine 

SDRATX - Asynchronous system trap (AST) service exit 
routine 


Connect or disconnect an interrupt vector to an 
interrupt service routine (ISR) in the 
task's own space 

$DRCIN - Connect to interrupt 

SDISIN - Disconnect interrupt. vector 


Cancel MARK TIME and SCHEDULE REQUEST directives 
SDRCMT - Cancel MARK TIME requests 
SDRCSR - Cancel SCHEDULE requests 


Disable or enable AST recognition directive processing 
SDRDAR - Disable AST recognition 
SDREAR - Enable AST recognitionDAR 


Disable or enable checkpointing directive processing 
SDRDCP - Disable checkpointing 
SDRECP - Enable checkpointing 


DRDSP contains the directive dispatch table 
BTRMV - Bytes to remove on exit 
DSPMP -<- Dispatch mapping table 


STRTRP 
USRPS 


DSPTBL - Directive dispatch table 

SEMTRP - EMT instruction trap routine 
SDPLM1 - Get pointer to definition block 
SDPLM2 - Get size of definition block 
SDRATP - NOP alter priority 

SDRLM1 - Get. first word on user stack 
S$DRLM2 - Get first DPB word 


TRAP instruction trap routine 
Pointer to user PS word 


End execution of the issuing task directive processing 

SDREIF - Terminate the execution of the issuing task if 
the event flag is clear 

SDREXT - Terminate the execution of the issuing task 

MTQUE - Subroutine to empty gueue 

SCNLN - Scan logical unit table 


Extend partition directive processing 
SDREXP - Extend the partition of the issuing task 


Get MCR command line or release MCR command buffer 
directive processing 

SDRGCL - Get MCR command line 

SRLMCB - Release MCR command buffer 


Get logical unit number information directive processing 
SDRGLI - Get LUN information 


Get partition parameters directive processing 
SDRGPP - Get partition parameters 


Get sense switch register contents directive processing 
SDRGSS - Get sense switch contents 


Get task parameters directive processing 
SDRGTK - Get task parameters 


Module 


DRGTP 


DRMAP 


DRMKT 


DRPUT 


DRQIO 


CROSS-REFERENCES 


Routines and Labels 


Get time parameters directive processing 
$DRGTP - Get current time parameters 


Mapping and send or receive by reference directive 
processing 

SDRCRW - Create address window 

SDRELW - Eliminate address window 

SDRGMX - Get mapping context of the task 

SDRMAP - Map window to region 

SDRRRF - Receive by reference 

SDRSRF - Send by reference 

SDRUNM - Unmap address window 


Mark time and run directive processing 

SDRMKT - Mark time; declare a significant event after a 
specified interval 

$DRRUN - Run the task after a specified interval or 
run the task after a specified interval and 
repeat the task periodically 


Specify floating-point, powerfail, and receive AST traps 
directive processing 

$DRFEX - Specify floating-point exception ASTs for the 
issuing task 


$DRPUT - Specify 


power recovery ASTs for the issuing 


task 
SDRRCV - Specify receive ASTs for the issuing task 
SDRRRA - Specify receive by reference ASTs for the 
issuing task 


Queue I/O directive processing 
ATRBK - Build attribute pointer block 
BDPKT - Build an I/O packet 


CKACC - Check if access also requested on create 

CKALN - Check for file already accessed on LUN 

CKCON - Check connect parameter buffer 

CKDIS - Fill disconnect parameter buffer and interlock 
LUN usage 

CKDMO - Check for volume marked for dismount 

CKNLN - Check for file accessed on LUN 

CKRAC - Check for read access priviliges and 
exit to transfer function 

CKRLK - Access or deaccess interlock 


CKWAC - Check for write access priviliges and exit 
to transfer function 
CKXIT - Exit polish to function exit 
SDQLM1 - Zero I/O status block 
SDQLM2 - Clear I/O status block 
SDRQIO ~- Queue I/O request 
SDRQIW - Queue I/O reguest and wait 
SDRQRQ - Insert I/O packet in a controller queue 
FCACC - Access file; check if volume marked for dismount 


FCCAW - Access file; check if file accessed 

FCCON =- Connect to process 

FCCRE - Create file 

FCCTL - Function is control function 

FCDAC - Deaccess file; check if file accessed on LUN 
FCDIS - Disconnect from process 

FCDSP - Function code dispatch vector 

FCIFC - Set illegal function status 

FCKIL - Flush I/O queue 


Module 


DRQIO 
(Cont. ) 


DRRAS 


DRREG 


DRREQ 


DRRES 


CROSS-REFERENCES 


Routines and Labels 


FCNCT - Network control function 
FCPKT - Build an I/0 packet 


FCRVB - Read virtual block; check if file accessed on LUN 
FCTRN - Function is a transfer function; address check and 


map function 


FCWVB - Write virtual block; check if file accessed on LUN 


FCXFR - Insert parameter 2 (within FCCTL routine) 
FCXIT - Clean stack and retrieve address of I/0 
packet (prior to entry into $DRQRQ) 
FILNM - Insert optional filename block 
IEALN - File already accessed on LUN; set file already 
accessed code 
IEBAD - Bad parameter; set bad parameter status 


IEBYT - Illegal byte count or alignment; declare odd byte 


status 

IECMN - Common error exit 

IEIFC - Illegal function; declare illegal function code 
status 

IENLN - No file accessed on LUN; set no file accessed 
status 

IENOD - No buffer space available; set no buffer status 

IEOFL - Specified device is offline 

IEOVR - Illegal load overlay UCB; declare illegal load 
overlay function status 


IEPRI - Privilege violation; set privilege violation status 
IESPC - Illegal buffer address specified; declare illegal 


buffer status 

ISssuC - Function is a NOOP function; declare successful 
completion status 

MSTK - Location to mark stack address 

MOVE3 <- Move extend and access control words into I/O 
packet 

OPPRM - Interpret optional block address 

RQPRM - Interpret required block address 

UNLCK - Unlock block 

UNLKT - Set up registers for unlock and exit 
to control address 


Receive and send directive processing 

SDRREC - Receive data and receive data or exit. 
Degueue data from the issuing task's receive 
gueue 

SDRSND - Send data; gueue data in a specified task's 
receive gueue 


Attach and detach region directive processing 

SDRATR - Attach region to the current task 

SDRCRR - Create a region and optionally attach to it 

SDRDTR - Detach the specified region, unmapping if 
necessary 

SDETRG - Detach region by attachment descriptor address 


Request task execution directive processing 
SDRREQ - Request task execution 


Resume or suspend task execution or alter task priority 
directive processing 

SDRATP - Alter task priority of a specified task 

SDRRES - Resume executing a task that has issued the 
suspend directive | 

SDRSPN ~- Suspend execution of the issuing task 


Module 


DRSED 


DRSST 


DTDRV 


DXDRV 


ERROR 


CROSS-REFERENCES 


Routines and Labels 


Significant event and event flag directive processing 
SDRCEF - Clear event flag and report its polarity 


$SDRDSE 
$SDRRAF 
SDRSEF 
SDRWFL 
SDRWFS 
SDRWSE 


STKWSE 


before clearing 

Declare a significant event 

Read all event flags (local and common) 

Set an event flag and report its polarity 
before setting 

Suspend task execution until LOGICAL OR of 
event flags occur 

Suspend task execution until a specified 
event flag is set 

Suspend execution of the issuing task until 
the next significant event 

Execute a wait for significant event directive 
for the current task 


Specify SST vector directive processing 
SDRSDV - Specify debugging aid SST vector 
SDRSTV - Specify task SST vector 


TC1l DECTAPE controller driver 


CNTBL 
RTTBL 
TEMP 
SDTTBL 
DTINI 
DTCAN 
DTOUT 


Address of current unit control block 
Error retry count and drive reset flag 
Temporary storage for controller number 
Driver dispatch table 

Initiator 

Cancel I/O operation 

Reference label 


RX11 floppy disk driver 


CNTBL 
DXCAN 
DXTBL 
DXINI 
DXOUT 
DXPWF 
DXRTY 
NXTSEC 


RTTBL 
SETBUF 
TEMP 
TRKSEC 


Address of current UCB for controller 
Cancel I/O entry point 

Driver dispatch table 

Initiator 

Log device timeout 

Powerfail entry point 

Retry last function 

Update block number, buffer address, and 
buffer pointer 

Error retry count for current unit 

Set up buffer pointer for CPU; SILO transfers 
Temporary storage for controller number 
Convert logical or physical block number 
to track-sector pair 


Error logging and error log processing 
SALEB1 - Allocate an error message block (EMB); 


SALEMB 
SBMSET 
SDTOER 
DTOTMP 
SDVCER 


SDVERR 
SNSO 


SNS1 
SNS2 


(alternate entry) 

Allocate an error message block 

Set a driver's bit in the I/O active bitmap 
Log timeout error; EMB formatting routine 
Device timeout storage 

Log device error bit errors; EMB formatting 
routine 

Same as $DVCER 

Call common nonsense interrupt code; 
0 - 17 

Call common nonsense interrupt code; 
20 - 37 

hae common nonsense interrupt code; 
40 - 57 


group 
group 


group 


Module 


ERROR 
(Cont. ) 


INITL 


IOSUB 


Routines 


SNS3 
SNS4 
SNS5 
SNS6 


NSI 
NSIER 
OPS 
OPC 
SQEMB 
TEMP 


System 
DEVMG 
SINITL 


OPMSG 
SPOOL 
PROMT 
SSYBEG 
SYSMG 
SYSID 
SSYTOP 
TRTRP 


CROSS-REFERENCES 


and Labels 

Call common nonsense interrupte code; group 
60 - 77 

Call common nonsense interrupt code; group 
100 - 117 : 

Call common nonsense interrupt code; group 
120 - 137 

Call common nonsense interrupt code; group 
140 - 157 

Nonsense interruption recursion counter 
Nonsense interrupt errors 

Nonsense interruption old PS storage 
Nonsense interruption old PC storage 

Queue an error message block (EMB) 
Nonsense interrupt PS storage 


startup and initialization routine 


"DEVICE dduu: NOT IN CONFIGURATION" message 
System gets control here after a boot to 
initialize and start up the system 

Send message to terminal 

Start of pool 

Terminal prompt character 

Beginning of dynamic storage region 
System identification message 

System ID 

Last address in the Executive 
Non-existent memory trap routine 


I/O related subroutine processing 
SACHCK - Address check, word aligned 


SACHK2 
SACHKB 
SACHKP 
SACHKW 
SASUMR 
SBLKC1l 


SBLKCK 
SCEFI 
$CEFN 
SCRPAS 
SDEUMR 
SDIV 
SDQUMR 


SDVMSG 
SECCOR 
SGTPKT 
SIOALT 


SIODON 
SIOFIN 


SIOKIL 


$LCKPR_ 
SMPLND 


SMPLNE 
SMPLUN 
SMPPHY 


—_ 


Address check 
Address check 
Address check 
Address check 
Assign UNIBUS 
Logical block 
entry) 

Logical block 


2-byte directive parameter block 
byte aligned 

parameter block 

Parameter block, word aligned 
mapping registers 

check routine (alternate 


check routine 

Convert event flag number for I/0 

Convert event flag number for directive 
Common register pass routine 

Deassign UNIBUS mapping registers (UMRs) 
Integer divide magnitude numbers 

Dequeue from UNIBUS mapping register (UMR) 
wait 

Device message output to task termination 
notification task 

Common ECC correction code for RP04/RK06 
Get I/O packet from request gueue 


I/O done (alternate entry); finish I/O 
processing 
I/O done; finish I/O processing 


Finish I/O processing where unit and controller 
are not to be idle 

Kill I/0; flush all I/0 
current task and cancel 
Lock processing routine 
Map logical unit number 
redirected device ; 
Map LUN for exit 

Map LUN 

Map to physical address 


reguests for the 
current I/0 


(LUN); check for 


Module 


IOSUB 
(Cont. ) 


LOADR 


LOWCR 


LPDRV 


Routines 


SMPPKT 


SMPUBM 
SMPVBM 
SMUL 

SRELOC 


SRELOM 
$RELOP 
SRLCH 

$RQCH 

SSCDV1 
SSCDVT 
SSTMAP 
SWTUMR 


Task to load 


IOSB 

LDRBF 
LDRBK 
LDRDP 
LDRFC 


LDRLN 
LDRTK 
$LOADR 


START 


DSW 


SSTACK 


R/W 


CROSS-REFERENCES 


and Labels 


Map a read/write virtual function in an I/0 
packet to a read/write logical function 
Map UNIBUS to memory 

Map virtual block number 

Integer multiply magnitude numbers 
Relocate virtual address into a relocation 
bias and displacement in block 

Relocate and map address 

Relocate UNIBUS physical address 

Release channel 

Request channel 

Scan device tables (alternate entry) 

Scan device tables 

Set up UNIBUS mapping address 

Wait for change in UNIBUS mapping register 
state 


and checkpoint all nonresident tasks 

status double word 

I/O DPB; buffer address 

of I/O transfer 

I/O DPB; DIC, DPB size 

I/O DPB; function code 

LUN 1 

EFN l 

I/O status doubleword address 

no AST service routine 

R/W I/O DPB; buffer length 

R/W I/O DPB; pointer to reguest task TCB 

1. Read a non-resident task into memory 
and initialize it for execution 

2. Read a previously checkpointed task back 
into memory and restart its execution 

3. Write a checkpoint image of a running task 

and free its partition 


I/O 
R/W 
LBN 


R/W 


me tA SS NO 


Interrupt and trap vectors 
SEMTRP - EMT instruction trap 


SILINS - Illegal instruction trap 
SIOTRP - IOT instruction trap 
SNONSI - Nonsense interrupt vector 
STRACE - Breakpoint trap 

STRPO4 - Trap to 4 

STRTRP - TRAP instruction trap 
Pointers 


Address of directive status 

Directive status word 

FCS impure area pointer 

FORTRAN impure area pointer 

Overlay run time system impure area pointer 
Executive stack area 


LP11/LS11 line printer controller driver 


CNTBL 
LPCAN 
LPINI 
LPINT 
LPOUT 
LPPWF 
LPRNT 
SLPTBL 
TEMP 


Address of UCB 

Cancel 1/0 

Driver initiator 

Interruption processing 

Device timeout processing 

Powerfail return 

Fill line printer buffer 

Driver dispatch table 

Temporary storage for controller number 


Module 


MMDRV 


MTDRV 


NLDRV 


PARTY 


CROSS-REFERENCES 


Routines and Labels 


RH11/RH70 TMO2/TM03 magnetic tape controller driver 


BSPACE 
CHKEOV 
CNTBL 
DRVCLR 
FMTBL 
INTADD 
LGFCN 
MMCAN 
MMDINT 


MMINI 
MMPWF 
SMMTBL 
REWND 
RLCH 
RQCH 
RTTBL 
SELECT 
SELERR 
SPCBK 
SPCFL 
SPTBL 
TEMP 
WRBLK 
WREOF 


Backspace one record 

Check for logical end of volume 
Address of current UCB 

Issue drive clear 

Format code save area 

Current interruption service address 
Legal function dispatch table 

Cancel I/O operation 

TU16 diagnostic interruption and timeout 
handler 

Tape controller initiator 

Powerfail processing 

Driver dispatch table 

Rewind function 

Release channel 

Reguest channel 

Error retry count 

Select drive 

Select error 

Space block function 

Space file function 

Space checking 

Temporary storage for controller number 
Write logical function 

Write tape mark function 


TM11 magnetic tape controller driver 


BSPACE 
CHKEOV 
CNTBL 
INTADD 
LGFCN 
MTCAN 
SMTCLK 
MTDINI 
MTINI 
MTOUT 
SMTTBL 
RDBLK 
REWND 
RTTBL 
SELECT 
SELERR 
SPCBK 
SPCFL 
SPTBL 
TEMP 
WRBLK 
WREOF 


~- Backspace one record function 

Check for logical end of volume 
Address of current unit control block 
Current interuption service address 
Legal function dispatch table 

Cancel I/O operation 

Reference label for timeout 
Diagnostic interruption and timeout handler 
Tape controller initiator 

Device timeout processing 

Driver dispatch table 

Read logical function 

Rewind function 

Error retry count 

Select a tape drive 

Select error 

Space block function 

Space file function 

For space checking 

Temporary storage for controller number 
Write logical function 

Write tape mark function 


Null device driver 
SNLTBL - Driver dispatch table 


NLINI 


Null driver executable code 


Memory parity interrupt handling 


ERTRK 
EXMSG 
SPARTB 


SMPCTL 


Address/data group 0 and 1, time of last error 


Executive parity error message 
Dummy control status register 
nonexistant registers 

New cache parity CSR contents 


(CSR) for 


Module 


PARTY 
(Cont. ) 


PLSUB 


POWER 


PPTAB 


PRDRV 


QUEUE 


REQSB 


CROSS-REFERENCES 


Routines and Labels 

SMPCSR - Vector of cache CSR addresses 

MSTAT - First two parity CSRs 

PARLV - Interruption recursion level counter 
RECURS - Jump to halt processor 

STAT - Memory status register 

PARER - Memory parity error interrupt processing 
Program logical address space (PLAS) common subroutines 
SCKACC = Check desired access of a task into a region 
SCRATT - Create attachement descriptor 

SSRATT - Search for attachment descriptor 

SSRNAM - Search for named partition 

SSRWND - Search for specified address window 
SUNMAP - Unmap address window 

Power failure recovery processing 

SLDPWF - Save APR5; reference label for LOAD 

PDOWN - Powerfail interrupt processing 

SPOWER - Power failure recovery processing routine 
PUP - Power up interrupt processing 

PWBTM - Volatile register storage 

PWVCT - Powerfail vector 

Device tables 


SPPDAT - Start of device tables 
SPPEND - End of device tables 


PC1l1/PR11 paper tape reader driver 

- Address of unit control block 

- In process I/O tranfers are not terminated 
- Controller initiator 

- Controller interruption processing 

- Device timeout processing 

- Powerfail return 

- Driver dispatch table 

- Temporary storage for controller number 


CNTBL 
PRCAN 
PRINI 
SPRINT 
PROUT 
PRPWF 
$PRTBL 
TEMP 


General gueuve manipulation processing 


$CLINS 
SCLRMV 
SQINSF 
SQINSP 
SQMCRL 
SQRMVF 
SQRMVT 


- Clock 
- Clock 
- Queue 
- Queue 
- Queue 
- Queue 
- Queue 


queue insertion 

gueue removal 

insertion at end of list 
insertion by priority 

MCR command line 

removal from front of list 
removal by TCB address 


Task reguest related subroutines 
SABCTK - Abort current task 


SABTSK 
SACTTK 
SACTRM 
SBILDS 
SCHKPT 
SDASTT 
SDQAC 

SEXROQF 
SEXRON 
SEXRQP 
SFNDSP 
SICHKP 
SLOADT 


- Abort 


task 


- Put task in active task list 
- Remove task from the. active task list 


- Build 


stack and initialize header 


- Checkpoint task 
- Declare AST trap 


- Degueue AST block 
- Executive request 
~ Executive request 
- Executive reguest 
- Find space in PCB 


gueued by SQASTC 

with FIFO gueue insert 

with no gueue insertion 

with gueue insert by priority 
list 


- Initiate checkpoint 
- Put task in loader queue 


Module 


REQSB 
(Cont. ) 


SSTSR 


SYSCM 


Routines 


SMAPTK 
SNXTSK 
SQASTC 
SQASTT 
SRLPAR 
SRLPR1 
SSETCR 
SSETF 

SSETM 

SSETROQ 
SSETRT 
SSTPCT 
SSTPTK 
SSRSTD 
STSTCP 
STSKRP 
STSKRQ 
STSKRT 
SUISET 


CROSS~REFERENCES 


and Labels 


Map task address window 

Assign next task to partition 

Queue AST to task 

Queue AST to task 

Release task partition; get PCB address 
Release partition; clear busy 

Set conditional schedule request 

Set event flag; convert to mask and address 
Set event flag 

Set schedule request 

Set schedule reguest for current task 
Stop current task 

Stop task 

Search system task directory 

Test if checkpoint should be initiated 
Task reguest (default UIC) 

Task reguest (UCB specified) 

Task request (default UCB) 

Establish default UIC and current UIC 


Synchronous system trap (SST) service routine 


SEMSST 
FLFRK 

FLSTS 

SFPLTRP 
SFLTRP 
SFPINT 
SILINS 
SIOTRP 
SSGFLT 
SSTXT 

STRACE 


STRPO4 


System 
SABTIM 
SACTHD 
SBTMSK 
SCFLPT 
SCKCNT 


SCKCSR - 


SCKLDC 
SCLKHD 
SCOMEF 
SCOPT 

SCRAVL 
$DEVHD 
SDYPMN 
SERRHD 
SERRLM 
SERRPT 
SERRSQ 
SERRSV 
SERRSZ 
SEXSIZ 
SFMASK 
SFRKHD 


processing . 

Non-RSX EMT/TRAP instruciton 
Floating-point fork block 
Floating-point status 

Floating-point exception (11/40) 
Floating-point exception (11/45) 
Programmed interrupt request processing 
Illegal or reserved instruction trap routine 
IOT instruction trap routine 

Segment fault trap routine 

Common SST exit routine 


TRACE (T-bit) or break point instruction (BPT) 


trap routine 
Traps occuring at 4 (odd address, 
non-existant memory, etc.) trap routine 


common data areas 


H.CSP; current stack pointer 

T.MXSZ; active task list listhead 

Bit mask table 

W.BOFF; pointer to first checkpoint file PCB 
T.ASTL+2; address of clock count register 
T.EFLG; address of clock control status 
register 

T.EFLG+2; clock load count 

P.TCB; clock gueue 

T.TCB; common event flags 1. -~- 16. 
P.STAT; pointer to command output UCB 
P.PRI; dynamic storage listhead 

H.FCS; pointer to first DCB 

H.VEXT; February, March 

Error logging message queue listhead 
Limit on resident error logging data 
W.BHVR; pointer to error logger TCB 
Universal error sequence number 

Pointer to error file identification 
Resident bytes of error logging data 
W.BSIZ; address of last byte in Executive 
P.WAIT+2; system feature mask 

P.SIZE; fork queue listhead 


Module 


SYSCM 
(Cont. ) 


SYSDF 


SYSTB 


SYSXT 


Routines 


SHEADR - 
SINTCT - 
SIOABM - 
SLDRPT - 
SLOGHD - 
SLSTLK - 
SMCRCB - 
SMCRPT - 
SMXEXT - 


SPARHD - 
SPARPT - 
SPKAVL - 
SPKMAX - 
SPKNUM - 
SPWRFL - 
SRQOSCH - 
SSHFPT - 
SSIGFL - 
SSTKDP - 
SSYSID - 
SSYSIZ - 
SSYUIC - 
STKNPT - 
STKPS - 
STKTCB - 
STSKHD - 
STTNS - 
SUMRHD - 
SUMRWT - 


Contains 


Contains 
SDEVTB - 


System 


SDIRSV - 
SDIRXT - 
SFINBF - 
SFORKO - 


SFORKI1 - 
SFORK2 - 


$FORK - 


SINTSC - 
SINTSE - 
SINTSV - 
SINTX1 - 
SINTXT - 
SNONSI - 
SNSO - 
SNS1 - 
SNS2 - 
SNS3 - 
SNS4 - 
SNS5 - 


CROSS-REFERENCES 


and Labels 


T.LNK; pointer to current task header 
P.MAIN; clock interrupt ticks count 

Device I/O active bitmap 

H.FORT; pointer to loader TCB 

T.NRPC; logical device assignment list 
T.LDV; lock word (TCB address of owner) 
T.LBN+1; MCR command block address 

H.OVLY; pointer to MCR TCB 

GLobal task size limit for extend task 
directive 

H.CUIC; pointer to partition table 

P.BUSY; parity address vector table pointer 
Pointer to first packet in list 

Maximum number allowed in list 

Number of packets currently in list 

H.EFLM; powerfail recovery pointer 

H.EFSV; schedule request TCB address 
W.BATT; pointer to shuffler TCB 

H.EFLM+2; task waiting for significant event 
H.FPSA; stack depth indicator 
T.NAM+2,T.RCVL; system identification 

Size of memory in 32 word blocks 

T.UCB; default system UIC (mapped or unmapped) 
T.RCVL+2; pointer to TKTN TCB 

Ticks per second 

H.FPVA; pointer to current task TCB 

W.BLVR; pointer to system task directory 
Tick of second 

Mapping assignment block listhead 

UMR wait queve listhead 


directive status codes, system global and 
control block offset definitions 


system device tables 
Device tables 


entrance, exit, and processor dispatching 


routines 
Directive save routine 
Directive exit 


Finish terminal 
Fork and create 
entry) 

Fork and create 
Fork and create 
directive) 

Fork and create 


input buffered 
system process 


system process 
system process 


system process 


I/O 
(alternate 


and save R5 
(CINTS 


(called from 


I/O driver) 
Interrupt save (CINTS directive) 

Interrupt save (error logging devices) 
Interrupt save 
Interrupt exit 
Interrupt exit 


Nonsense 
Nonsense 
Nonsense 
Nonsense 
Nonsense 
Nonsense 
Nonsense 


interrupt 
interrupt 
interrupt 
interrupt 
interrupt 
interrupt 
interrupt 


RTI routine 
vector 
vector 
vector 
vector 
vector 
vector 


Module 


SYSXT 


(Cont. ) 


SYTAB 


TDSCH 


TTDRV 


Routines 


SNS6 
SNS7 
RESCH 
SSAVNR 
SSWSTK 


System 


CROSS-REFERENCES 


and Labels 


Nonsense interrupt vector 

Nonsense interrupt vector 

Rescheduling reguested; clear schedule request 
Save non-volatile registers 

Switch from task stack to system stack 


tables needed for resident tasks and 


bootstrapping the system 


~LDRHD - Loader task header 


SPCBS 
$STD 


Loader partition control block 
Loader task control block 


Time dependent scheduling and device timeout 


SCKINT 
DVOUT 
ROBIN 
RNDCT 
SWAP 


SWPCT 
TDS 
TIMXT 


UPTIM 


Terminal 


BECHOB 
CLKSW 
CNTBL 
CRTRUB 
CTRLC 
CTRLR 
CTRLU 
CTRLZ 
DHCSR 
SDHINP 


SDHOUT 


DHTBL 
DHTMP 
DJCSR 
SDJINP 


SDJOUT 


DJSAV 
DJTBL 
DJTMP 
$DLINP 
SDLOUT 
DLSAV 
DLTMP 
$DM11B 


DMHUP 


DMSAV 
DMTBL 


processing 

Clock interrupt processing routine 

Test for one second elapsed time 
Executive round robin scheduling 

Clock ticks to next schedule interval 
Disk swapping algorithm; reduce swapping 
priority of resident tasks 

Clock ticks to next swapping interval 
Time dependent scheduling 

Exit time dependent scheduling if no 
unprocessed clock ticks remain 

Update absolute and real time of day and date 


driver for DL11-A line interface and 
DH11/DJ11/D211 line multiplexers 

Echo next byte 

DM11-BB clock switch word 

Address of unit control block 

Backspace, space, backspace (/ /) 

Control output message (MCR>) 

Control R processing 

Control output message (U) 

Control output message (2) 

DH11 CSR address 

DH11 terminal multiplexer input interrupt 
processing 

DH11 terminal multiplexer output interrupt 
processing 

Pointer to DH11 table 

Temporary storage for controller number (DB11) 
DJ11 CSR address 

DJ11 terminal multiplexer 
processing 

DJ11 terminal multiplexer 
processing 

DJ11 terminal multiplexer 
Pointer to DJ11 UCB table 
Temporary storage for controller number (DJ11) 
DL11 terminal input interrupt processing 

DL11 terminal output interrupt processing 
DL11 terminal save routine 

Temporary storage for controller number (DL11) 
DM11-B or DM11-BB modem control interrupt 
processing 

Subroutine to hang up a DM11-BB unit if not 
ready 

DH1l1 terminal multiplexer save routine 
DM11-BB CSR address 


input interrupt 
output interrupt 


save routine 


Module 


TTDRV 
(Cont. ) 


XBDRV 


Routines 


DMTMO 
DOCTLC 
DZCLK 
DZCLKS 
DZCSR 
SDZINP 


$DZOUT 


DZSAV 
DZTBL 


DZTMO 
DZTMP 
ECHOB1 
ECHOB 
FCHAR 
FILTB 
FWRITE 
GETBF 
GETBF2 
GMCTAB 
ICHAR 
INPINI 
INPPT 
INPTO 
INPT1 
INPT2 
IODON 
JTTINI 
LEVHSM 
MECHO1] 
OCHAR 
OUTPT 
OUTPT1 
SYNTAB 
TCHR1 
TINPL 
TICAN 
TTCHK 
TTHUP 


TTINI 
TTOUT 
TTOUTI 
TIPWFE 


STTTBL 
UCBTB 
UCJTB 
UCZTB 


DA11-B 
CNTBL 
UNITBL 


SXBTBL: : 


DBINIT 


SUCC: 
DBTMO: 


CROSS-REFERENCES 


and Labels 


DM11-BB time out routine 

Lock out input characters 

Clock queue entry address 

DZ11 clock switch word 

D211 CSR address 

DZ11 terminal multiplexer input interrupt 
processing 

DZ11 terminal multiplexer output interrupt 
processing : 

DZ11 terminal multiplexer save routine 
Pointer to DZ1l UCB table (indexed by 
controller number) 

DZ11 time out routine 

Temporary storage for controller number (D211) 
Display (send out) a character 

Echo next byte 

Send a character to a terminal 

LA30S carriage return fill table 
Breakthrough write (disallow control-0O) 
Get input buffer and set terminal control block 
Allocate a core block 

Terminal characteristics 

Process an input character 

Copy UCB address 

Input reguest in progress 

Enable input character handling 

Fork to finish an input request 
End-of-line fork process 

Finish I/O operation 

Go to terminal initiator 

Leave hold-screen mode () 

Multi-echo processing 

Send a character to a terminal 

Start or continue an output stream 

Test if a fill should be echoed 

Escape sequence syntax table 

Teminal characteristics 

Unsolicited input fork process 

Cancel I/O operation (force I/O complete) 
Terminal driver special parameter checking 
Cancel I/O and BYE if DM1ll or DZ1l1 line hangs 
up 

Terminal initiator 

Terminal driver timeout entry point 
Terminal timeout; finish I/O operation 
Powerfail entry point (loaded as a loadable 
driver) 

Device initiator entry point 

Address of UCB for line 

Address of line's UCB (DJ11) 

UCB address for each line; indexed 

by line (unit) number 


Interprocessor Communications Driver 


- Unit impure data table (reference label) 

~ Unit impure data table 

- Device dispatch table 

- DA11-B parallel communications link controller 
I/O initiator entry point 

- Successful completion entry 

- Device timeout entry 


Module 


XBDRV 
(Cont. ) 


XMDRV 


Routines 


DBCANC: 
DBPWRF: 
SXBINT:: 
IEVER: 
SUCDN: 
INTDN: 
TXDN: 
NOTHING: 
EXIT: 
ERR: 
DBSET: 
DBEXIT: 
XBRCV: 
RESYNC: 
MYSYNC: 


RSX-11M 


U.XQ: 
U.RQ: 
U.ERR: 
U.XAST: 
U.ABO:; 


IOTYPE 
COUNT: 
UMR: 
UMRSUM 
BASE: 
SXMTBL:: 
CNTBL: 
TEMP: 
LIST: 
BTAB: 
XLTAB: 
AXTAB: 
XMRET: 
XMINITs: 
PKTOK: 
FINPKT: 
XMDNR: 
XMSPC: 
XMIFC: 
TRAN: 
TRY: 
GIVE: 
SETDMC 
WRDYIC 
WRDYIS 
MAP22: 
SXMINP 
XMTRDY 
RCVRDY 
FPERR: 
$XMOUT 
XMTCOM 
RCVCOM 
CNTLO: 
BAD: 
XMINTX: 
XMSET: 


ee se 086 


CROSS-REFERENCES 


and Labels 


Device cancellation entry 
Device powerfail entry 
DA1L1I-B interrupt routine 
Unrecoverable error finish 
Successful completion 

Finish 1/0 

Check for enable receive 
Check for interrupt 

Wait for transfer completion 
Error checking 


Check for valid UCB address and device online 


Exit from interrupt 

Initiate device for unsolicited receive 
Receive error. Check for receiver active 
Receive error. Device must be resynced 


DMC11 Driver 


UCB displacements used 

Transmit listhead address 

Receive listhead address 

Error status 

Exception AST block address 

Number of I/O reguests marked for abort 
Listhead displacements 

SELO request type 

Sent count 

Next UMR to use 

Sum of both UMR addresses 
Microprocessor base table 

Driver dispatch table 

UCB address table 

Temporary unit save 

Listheads 

Multiple unit base table addresses 
Multiple unit listhead addresses 
Address extension bits 

Return point 

Initiate DMC I/O entry 

Finish packet with "IS.SUC" status 
Alternate entry for PKTOK 

Device not ready 

Illegal buffer 

Illegal function code 

Transfer function 

Try to give transfer request to DMC 
Give buffer address and count to DMC 
Initialize DMC hardware 

Release port and wait for RDYI clear 
Wait for RDYI set 

Do 22-bit mapping and load data port 
Process RDYI interrupt 

DMC ready for transmit buffer 

DMC ready for receive buffer 

Force procedure error 

Process completion interrupt 
Transmit buffer complete 

Receive buffer complete 

Control out 

Exit from interrupt 
Exit from interrupt 
Setup for interrupt routines and transfer 


(reference label) 


Module 


XMDRV 
(Cont. ) 


XPDRV 


XQDRV 


Routines 


RDYINT: 
BUFCOM: 
XMFRK: 
XMTMO: 
XMCANC: 
XMPWRFE : 
XMCANC: 
KILL: 
RQPABO: 
ROP: 
QXAST: 
QAST: 


DQRAP : 
RAP: 
ITRY: 
PORT: 
IPORT: 
NTXMT:; 
NTRCV: 
NTFIX: 
NTABO: 


CROSS-REFERENCES 


and Labels 


Give buffer to DMC 

Process buffer complete 

Start fork process if fork process not running 
Timeout processing entry 

Cancel I/O entry 

Powerfail recovery entry 

Indicate I/O kill was done 

Kill the device 
Alternate entry 
Alternate entry 
Queue an AST to 
Queue an AST to 
event) 

Degueue and return an I/O packet 

Return an already degqueued I/O packet 

Try to set up another buffer from interrupt level 
Reguest the data port 

Reguest the data port from interrupt level 
Initiate DECNET transmit 

Initiate DECNET receive 

DECNET error recovery 

Abort by CCB address 


KILL: 

KILL: 

CCP (clear AST block address) 
CCP (declare significant 


for 
for 
the 
the 


DP1l Synchronous Communications Driver 


CNTBL: 
UNITBL: 
TEMP: 
UNIT: 
SXPTBL: 
DPINIT: 


DPSUCC: 
DPFIN: 

DPPWRF: 
DPCANC: 
DPTMO: 

SXPINP: 
SXPOUT: 
DPTXND: 
DPRXER: 
DPRCV: 


DPSET: 


DPSXT: 


Reference label for UNITBL: 

UCB addresses 

Reference label for UNIT: 

Temporary storage for unit number 

Driver dispatch table 

DP11 Synchronous Communications Controller I/0 
initiator 

Return successful status 

Idle controller and mark unit idle 

Power fail service routine 

I/O cancellation entry 

Timeout service routine 

DP11 input interrupt service routine 
Transmitter interrupt service routine 

End of transmission 

Receiver error detected. Resync controller 
Unsolicited receive initialization. Activate 
controller 

Set up register R4 with CSR address, R5 with UCB 
address, unit number in low-order 4 bits of unit 
Dismiss interrupt 


DQ11 Synchronous Communications Driver 


CNTBL: 
UNITBL: 
TEMP: 
UNIT: 
SXQTBL:: 
DOINIT: 


DORET: 
succ: 
UNSUCC: 
DQCANC: 
DQPWRF : 
DQTMO: 


Reference label for UNITBL: 

UCB address tabel 

Reference label for UNIT: 
Temporary storage for unit number 
Device dispatch table 

DQ11 Synchronous Communications Controller I/0 
initiator 

Return from initiator 

Do I/O done (successful) 

Do I/O done (unsuccessful) 

I/O cancellation entry 

Powerfail routine entry 

Timeout routine entry 


Module 


XQDRV 
(Cont. ) 


XUDRV 


Routines 
TNEXT: 
TOAN: 
RNEXT: 
ROAN: 
SXQOUT:: 
TXTRN: 
DQTXDN: 
ERROR: 


RBCERR: 
DQSET: 


SDQEXIT: 
SXQINP:: 
RXENT: 


DORCV: 
RESYNC: 


SETUP: 


CROSS-REFERENCES 


and Labels 


Select appropriate buffer address register 
(transmit) 

Select appropriate buffer address register 
(transmit - double buffering ahead) 

Select appropriate buffer address register 
(receive) 

Select appropriate buffer address register 
(receive - double buffering ahead) 
Transmit interrupt routine 

Finish transmit 

Transmit done 

Error routine 

Receive BCC error 

Set up R4 with RXCSR address, R5 with UCB 
address, 

unit number in low-order four bits of unit. 
Jump to SINIXT to dismiss interrupt 
Receive interrupt routine 


to 


to 


to 


to 


End of receive routine. Clear spurious clock 


error, save registers, check for buffers 
finished. 

Initialize DQ for unsolicited receive 
Re-sync or initialize receiver to 
receive from a dead start. 

Set up device with next receive buffer 


DU11 Synchronous Communications Driver 


CNTBL: 
UNITBL: 
TEMP: 
SXUTBL: 
DUINIT: 


ee 


DUSUCC: 


DUFIN: 
DUPWRF : 
DUCANC: 
DUTMO: 
SXUINP: 
SXUOUT: 
DUTXND: 
DURXER: 
DURCV: 


DUSET: 


DUSXT: 


Reference label (for UNITBL:) 

UCB address table 

Reference label (for UNIT:) 

Driver dispatch table 

DU11 Synchronous Communication Controller 
I/O initiator 

Return successful status for mode change 
full- or half-duplex) 

End mode change request routine 

Powerfail service routine 

I/O cancellation service routine 

Timeout service routine 

Input interrupt service routine 
Transmitter interrupt service routine 

End of transmitter interrupt service 
Receiver error - re-syne controller 
Activate controller to be ready to accept 
data 


use 


use 


use 


use 


Set up R4 with CSR address, R5 with UCB address, 


unit number in low-order 4 bits of unit 
Jump to SINTXT to dismiss interrupt 


Module 


XWDRV 


CROSS-REFERENCES 


Routines and Labels 


DUP11 Synchronous Communications Driver 


CNTBL: 
UNITBL: 
TEMP: 
UNIT: 


SXWTBL:: 


DWINIT: 


DWSUCC: 
DWFIN: 
DUPWRE : 
DWCANC: 
DWTMO: 


SXWINP:: 
SXWOUT:: 


DWTXND: 
DWRXER: 
DWRCV: 


DWSET: 


Reference label for UNITBL: 

UCB address table 

Reference label for UNIT: 

Temporary storage for unit number 

Driver dispatch table 

DUP11 Synchronous Communication Controller 
I/O initiator 

Successful device mode change request 

End of device mode change request routine 
Powerfail service routine 

I/O cancellation service routine 

Timeout service routine 

DUP11 input interrupt service routine 
Transmitter interrupt service routine 

End of transmitter interrupt service 
Receiver error detected. Resync controller 
Activate controller to be ready to receive 
data 

Set R4 with CSR address, R5 with UCB address, 
unit number in low-order 4 bits of unit 


9.2 RSX-11M EXECUTIVE GLOBAL CROSS~REFERENCE 

The Executive global cross-reference contains an alphabetic listing of 
each global symbol alony with its value and the name of each 
referencing module. 


The value contains the suffix -R if the symbol is relocatable. 


The symbol # preceeds the module in which the symbol is defined. 


Symbol 


C.SYst 
DV.MXD 
DV.PSE 
DV .TTY 
DV.UMD 
DSSYNM 
D.DSP 
D.MSK 
D.NAM 
D.PCB 
D.RSOO 
D.RS1 


D.RS10 


D.RS17 
D.RS19 
D.RS2 
D.RS22 
D.RS5 
D.RS6 
D.RS7 
D.RS8 


Value 


000006 
000100 
010000 
000004 
000200 
000000 
000012 
000014 
000004 
000034 
000000 
177777 


177766 
177760 


177757 
177755 
177776 
000002 
177773 
177772 
177771 
177770 


Modules That Reference Symbol 


= 3 4 3 Se 


EXEDF 
EXEDF 
EXEDF 
EXEDF 
DRQIC 
SYSDF 
DROIC 
DRQIOC 
DRASG 
DROQIC 
DRSED 
CORAL 


# SYSDF 


DRDCF 
DRDSF 
PLSUB 
SYSDF 
SYSDF 
DRDSP 
DREIF 
DRGLI 
DROIO 
DRABC 
DRDAR 
DRRAS 


ate He He HE FE tr 


TTDRV 
IOSUB 
INITL 
IOSUB 
EXEDF 


EXEDF 
EXEDF 
EXEDF 
EXEDF 
SYSDF 
DREXP 


SYSDF 
DRMAP 
SYSDF 


DRGPP 
DRRES 
DRQIO 
SYSDF 
DRREQ 
DRDCP 
DRRES 


IOSUB 
IOSUB 
IOSUB 


INITL 
IOSUB 


DRMAP 


DRMKT 


DRMAP 
DRSED 
# SYSDF 


DRRES 
DREXP 
# SYSDF 


POWER 


IOSUB 
POWER 


DRREG 


DRREG 


DRRAS 
SYSDF 


SYSDF 
DRMAP 


TDSCH 


TDSCH 


DRREQ 


DRRES 


SYSDF 


DRPUT 


Symbol Value 


D.RS80 
D.RS81 
D.RS84 
D.RS85 
D.RS86 
D.RS87 
D.RS90 
D.RS92 
D.RS93 
D.RS94 
D.RS95 
D.RS96 
D.RS97 
D.RS98 
D.RS99 
D.UCB 

D.UCBL 
D.UNIT 
D.VCAN 
D.VINI 
D,.VOUT 
D.VPWF 
EC.DTO 
EC .DVC 
EC.NSI 
E.LGTH 
E.OPC 

E.RTRY 
IE .ABO 
IE.ALN 
IE.BAD 
IE.BBE 
IE.BLK 
IE.BYT 
IE.CNR 
IE.DAA 
IE.DAO 
IE.DNA 
IE.DNR 


IE.EOF 
IE.EOT 
IE.EOV 
IE.FHE 
IE.FLN 
IE.IEF 
IE.IFC 


IE.LCK 
IE.MOD 
IE.NLN 
IE.NOD 
IE.OFL 
IE.OVR 
IE.PRI 
IE.RSU 
IE.SPC 


IE .ULK 
IE.VER 


177660 
177657 
177654 
177653 
177652 
177651 
177646 


177644 


177643 
177642 
177641 
177640 
177637 
177636 
177635 
000002 
000010 
000006 
000002 
000000 
000004 
000006 
000140 
000001 
000141 
000056 
000022 
000016 
177761 
177736 
177777 
177710 
177754 
177755 
177667 
177770 
177763 
177771 
177775 


177766 
177702 
177765 
177705 
177657 
177637 
177776 


177745 
177753 
77733 
177751 
177677 
177756 
177760 
177757 
177772 


177653 
177774 


Modules That Reference Symbol 


3 +e 


CROSS-REFERENCES 


DRATX 
SYSDF 
DREXP 
DRMAP 
DRMAP 
PLSUB 
DRASG 
DRASG 
CVRTM 
DRREG 
DRRES 
IOSUB 
DRDSP 
DRSST 
DRDSP 
DRASG 
DRASG 
DRASG 
EXEDF 
DRQIO 
EXEDF 
EXEDF 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
EXEDF 
DTDRV 
DRQIO 
ADDRV 
DRDRV 
DXDRV 
DRQIO 
GRDRV 
IOSUB 
MMDRV 
IOSUB 
ADDRV 
ICDRV 
MMDRV 
MMDRV 
MMDRV 
MMDRV 


-ICDRV 


GRDRV 
DBDRV 
DTDRV 
TTDRV 
IOSUB 
ICDRV 
DROQIO 
DROQIO 
DROQIO 
DRQIO 
DROQIO 
TTDRV 
ADDRV 
TTDRV 
IOSUB 
DBDRV 
DXDRV 


He He te te 4 SH: He He He SE SE +e 


Se SE te te 


DRGCL 


DRMAP 
SYSDF 
DRREG 
SYSDF 
SYSDF 
SYSDF 
SYSDF 
SYSDF 
SYSDF 
SYSDF 
DRSED 
IOSUB 
SYSDF 
EXEDF 
EXEDF 
EXEDF 
IOSUB 
EXEDF 
TDSCH 
POWER 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
IOSUB 
IOSUB 


DRQIO 
MMDRV 
IOSUB 
ICDRV 


DBDRV 
MMDRV 
NLDRV 


DRPUT 
# SYSDF 


PLSUB 


TOSUB 
SSTSR 


INITL 


INITL 
INITL 


LPDRV 


ICDRV 


DKDRV 
TDSCH 
TTDRV 


DMDRV 


IOSUB 


TTDRV 


IOSUB 


GRDRV 


DMDRV 


# SYSDF 


# SYSDF 


# SYSDF 
# SYSDF 


IOSUB 


IOSUB 
TOSUB 


TTDRV 


TTDRV 


DMDRV 
TTDRV 


DRDRV 
ISDRV 


TTDRV 


ICDRV 


DRDRV 


DRDRV 


DROIO 
MMDRV 


MMDRV 


DTDRV 


Symbol 


IE.WCK 
IE.WLK 


IO0.ATT 
IO.CLN 
IO.CON 
IO.DET 
I0.DIS 
IO.EOF 
IO.FLN 
I0.GTS 
I0.LOV 
IO .ONL 
IO.RLB 


IO.RLV 
IO.RPR 
I0..RVB 
I0.STC 
IO.STP 
IO.ULK 
I0.WLB 


IO.WLC 
IO.WLT 
IO.WLV 
IO.WVB 
IQ.UMD 
IQ.X 

IS.RDD 
IS.SUC 


I$ssll 
I.FCN 
I.PRI 
I.PRM 
I.TCB 
KISARS5 
KISAR6 
L.ASG 
L.NAM 
L.TYPE 
L.UCB 
L.UNIT 
MSSEXT 
MSSMGE 
M.BFVH 
M.BFVL 
M.LGTH 
M.UMRA 
M.UMRN 
M.UMVH 
M.UMVL 
PR4 
PR5 
PR6 
PR7 

PS 
P.ATT 


Value 


177652 
177764 


001400 
003400 
015400 
002000 
016000 
003000 
012400 
002400 
001010 
017400 
001000 


001100 
004400 
010400 
002500 
016400 
005000 
000400 


000420. 


000410 
000500 
011000 
000004 
000001 
000002 
000001 


000000 
000012 
000002 
000024 
000004 
172352 
172354 
000010 
000002 
000005 
000006 
000004 
000000 
000000 
000011 
000012 
000014 
000002 
000004 
000010 
000006 
000200 
000240 
000300 
000340 
177776 
000036 


Modules That Reference Symbol 


He OE HE 


He SHE HE HEHE te SEH OE SEH FH 


CROSS-REFERENCES 


DBDRV 
DBDRV 
MMDRV 
DRQIO 
DREIF 
GRDRV 
DREIF 
GRDRV 
MMDRV 
ICDRV 
TTDRV 
DRQIO 
ICDRV 
DBDRV 
DTDRV 
DTDRV 
TTDRV 
DROIO 
MMDRV 
GRDRV 
IOSUB 
DMDRV 
LOADR 
DBDRV 
DMDRV 
DTDRV 
IOSUB 
DRQIO 
DBDRV 
DXDRV 
ADDRV 
DRQIO 
IOSUB 
TTDRV 
ISDRV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
DRMAP 
DRASG 
DRASG 
DRASG 
DRASG 
DRASG 
SYSDF 
SYSDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
DRREG 


at He SHE He te te 


DKDRV 
DKDRV 


IOSUB 


DROQIO 


DMDRV 
DMDRV 


TTDRV 


IOSUB 


DMDRV 
LOADR 


DRQIO 
NLDRV 
DMDRV 


IOSUB 
DMDRV 


DKDRV 
DXDRV 
LPDRV 
ICDRV 


ICDRV 
ICDRV 


GRDRV 


ICDRV 
# SYSDF 


DRDRV 
DRDRV 


TTDRV 


DRDRV 
MMDRV 


DXDRV 
TTDRV 
DRDRV 


DRDRV 
DMDRV 
GRDRV 
MMDRV 
NLDRV 


NLDRV 
TTDRV 


TTDRV 


TTDRV 


DTDRV 


DROIO 
TTDRV 


IOSUB 


DXDRV 


DRDRV 
ICDRV 
NLDRV 


TTDRV 


TTDRV 


CROSS-REFERENCES 


Symbol Value Modules That Reference Symbol 
P.BLKS 000016 # EXEDF # SYSDF 
P.BUSY 000024 # EXEDF # SYSDF 
P.HDR 000032 DREXP DRRES ERROR LOADR REQSB 
# SYSDF SYSXT TDSCH TTDRV 
P.IOC 000003 # EXEDF # SYSDF 
P.LGTH 000042 DREIF DRREG REQSB # SYSDF 
P.LNK 000000 # EXEDF # SYSDF 
P.MAIN 000012 # EXEDF # SYSDF 
P.NAM 000004 # EXEDF # SYSDF 
P .OWN 000026 # EXEDF # SYSDF. 
P.SIZE 000016 # EXEDF # SYSDF 
P.STAT 000030 # EXEDF # SYSDF 
P.SUB 000010 # EXEDF # SYSDF 
P.SWSZ 000022 # EXEDF # SYSDF 
P.TCB 000026 # EXEDF # SYSDF 
P.WAIT 000020 # EXEDF # SYSDF 
SP.EIP 000001 ERROR # EXEDF IOSUB SYSXT 
SP .ENB 000002 ERROR # EXEDF 
SSSIEN 000115 # SYSCM 
S$$LDC 000001 # SYSCM 
SSSRTZ 000074 # SYSCM 
S$$TPS 000074 # SYSCM 
S.BMSK 177776 DTDRV ERROR EXEDF # SYSDF SYSXT 
S.BMSV 177774 ERROR # EXEDF IOSUEB # SYSDF SYSXT 
S.CCB 000030 # SYSDF 
S.CON 000010 DBDRV DKDRV DMDRV DRDRV DXDRV 
# EXEDF IOSUB MMDRV POWER SYSDF 
SYSXT TDSCH 
S.CSR 000012 ADDRV DBDRV DKDRV DMDRV DRDRV 
DTDRV DXDRV ERROR # EXEDF GRDRV 
ICDRV INITL LPDRV MMDRV SYSDF 
° TDSCH TTDRV 
S.CTM 000006 DBDRV DKDRV DMDRV DRDRV DTDRV 
DXDRV # EXEDF LPDRV MMDRV SYSDF 
SYSXT TDSCH TTDRV 
S.DHCK 000030 # SYSTB TTDRV 
S.FLG 000000 ICDRV . 
S.FRK 000016 # EXEDF IOSUB SYSDF SYSXT 
S.ITM 000007 DBDRV DKDRV DMDRV DRDRV DTDRV 
DXDRV # EXEDF LPDRV MMDRV SYSDF 
TTDRV 
S.LHD 000000 # EXEDF # SYSDF 
S.MPR 000030 IOSUB # SYSDF 
S.PKT 000014 DBDRV DKDRV DMDRV DRDRV DTDRV 
DXDRV ERROR EXEDF IOSUB LPDRV 
MMDRV # SYSDF TTDRV 
S.PRI 000004 ERROR # EXEDF IOSUB # SYSDF SYSXT 
TDSCH TTDRV 
S.RCNT 177772 ERROR # EXEDF IOSUB # SYSDF 
S.ROFF 177773 ERROR # EXEDF IOSUB # SYSDF 
S.STS 000011 DBDRV DKDRV DMDRV DRDRV DTDRV 
# EXEDF IOSUB LPDRV MMDRV SYSDF 
TTDRV 
s.vcT 000005 # EXEDF # SYSDF 
TS.CKR 000100 # EXEDF TTDRV 
TS.RDN 040000 # EXEDF TTDRV 
T.ASTL 000016 # EXEDF GRDRV TTDRV 
T.EXT 000000 # SYSDF 
T.IOC 000003 # EXEDF GRDRV TTDRV 
T.LGTH 000070 # SYSDF 
T.PCB 000046 # EXEDF TTDRV 
T.STAT 000032 # EXEDF TTDRV 


Symbol Value 


T.ST2 

T.ST3 

T2.ABO 
T2.AST 
UC.KIL 
UC.LGH 
UC.NPR 
UC.PWF 
UC.QUE 
UISARO 
UISDRO 
US.BSY 
US.CRW 
US.DSB 
US.ECH 
US.FOR 
US.LAB 
US.MDM 
US .MNT 
US .OFL 
US.OUT 
US.PUB 
US .SPU 
US ..UMD 
US .WCK 
U.ACP 

U.ATT 


U.BUF 


U.CNT 


U.CTL 
0.CWl 


U.CW2 


U.CW3 
U.CW4 
U.DMCS 
U.OWN 
U.RED 
U.SCB 


U.STS 


U.ST2 
U.UNIT 


U.VCB 

U2.CRT 
U2.ESC 
U2.HLD 
U2.LOG 
U2.LWC 
VSSCTR 


000034 
000036 
000100 
100000 
000004 
000003 
000100 
000020 
000040 
177640 
177600 
000200 
000004 
000010 
000002 
000040 
000004 
000020 
000100 
000001 
000001 
000004 
000002 
000010 
000010 
000032 
000022 


000024 


000030 


000004 
000010 


000012 


000014 
000016 
000064 
177776 
000002 
000020 


000005 


000007 
000006 


000034 
002000 
001000 
000040 
000400 
000001 
000400 


Modules That Reference Symbol 


HE He Se AE HE te 


He He Ste te 


He He SE te EE 


CROSS-REFERENCES 


EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDE 
DRQIO 
-EXEDF 
EXEDF 
DRQIO 
DRMAP 
DRMAP 
EXEDF 
EXEDE' 
EXEDF 
EXEDEF 
DROQIC 
DRQIO 
DRQIC 
DRQIO 
DRQIO 
EXEDF 
DRQIO 
DBDRV 
DRQIC 
DBDRV 
DRRES. 
DRASG 
TTDRV 
ADDRV 
DRDRV 
LPDRV 
ADDRV 
DTDRV 
MMDRV 
DRQIC 
DRGLI 
IOSUB 
ADDRV 
IOSUE 
DMDRV 
EXEDF 
SYSTB 
DRQIO 
EXEDF 
DBDRV 
DRRES 
INITL 
TTDRV 
DBDRV 
DRRES 
TDSCH 
DRQIC 
TTDRV 
DBDRV 
EXEDF 
DREIF 
EXEDE' 
EXEDF 
EXEDE' 
EXEDF 
EXEDEF 
SYSDEF 


Se 3 Sk 


+ 3 FF HE FE HE 


GRDRV 
ICDRV 
GRDRV 
GRDRV 
IOSUB 
EXEDF 
IOSUB 
POWER 
EXEDF 
EXEDF 
EXEDF 
IOSUB 
TTDRV 
TTDRV 
TTDRV 
DRRES 
EXEDF 
EXEDF 
DRRES 
EXEDF 
TTDRV 
EXEDF 
DKDRV 
EXEDF 
DKDRV 
EXEDF 
DREIF 


BFCTL 
DTDRV 
MMDRV 
DBDRV 
DXDRV 
TTDRV 
EXEDF 
DROIO 


DBDRV 
LPDRV 
EXEDF 
LPDRV 
TTDRV 
EXEDF 
IOSUB 
DKDRV 
DTDRV 
IOSUB 


DKDRV 
EXEDF 
TTDRV 
EXEDF 


DKDRV 
IOSUB 
DROIO 
TTDRV 
TTORV 
TTDRV 
TTDRV 
TTDRV 


TTDRV 
TTDRV 


TTDRV 


TTDRV 


EXEDF 
MMDRV 


EXEDF 
INITL 


DMDRV 
IOSUB 
DMDRV 
IOSUB 
EXEDF 


DBDRV 
DXDRV 
TTDRV 
DKDRV 
EXEDF 


IOSUB 
DRRES 


DMDRV 
MMDRV 
IOSUB 
TTDRV 


DMDRV 
DXDRV 
LPDRV 


DMDRV 
IOSUB 


INITL 
DMDRV 


MMDRV 
DTDRV 


IOSUB 


IOSUB 
POWER 
DRDRV 
DRDRV 
IOSUB 


DKDRV 
EXEDF 


DMDRV 
TOSUB 


POWER 
EXEDF 


DTDRV 
TTDRV 
MMDRV 


DRDRV 
EXEDF 
MMDRV 


DRDRV 
MMDRV 


IOSUB 
DRDRV 


TTDRV 
EXEDF 


TTDRV 


EXEDF 


EXEDF 


DMDRV 
IOSUB 


DRDRV 
LPDRV 
INITL 
EXEDF 


TTDRV 


DROQIO 
ICDRV 
SYSXT 


DRQIO 
POWER 


POWER 
DXDRV 


MMDRV 


Symbol Value 


W.BATT 
W.BLGH 
W.BOFF 
X.AST 
X.DSI 
X. FORK 
X.ISR 
X.dSR 
X.LEN 
X.LNK 
X.PSW 
X.REL 
X.TCB 
X.VEC 
X.VPC 
SABCTK 
SABTIM 
SABTSK 
SACHCK 


SACHKB 
SACHKP 


SACHKW 
SACTHD 


SACTRM 
SACTTK 
SADTBL 
SALCLK 
SALEB1 
SALEMB 
SALOCB 


SALOC1] 
SALPKT 
SASUMR 
SBILDS 
$BLKCK 


SBLKC1l 
SBLXIO 
SBMSET 


SBTMSK 
SBTSTP 
SCEFI 

SCEFN 

SCFLPT 
SCHKPT 
SCLKHD 
SCLPAR 
SCLRMV 
$CMBEG 
SCMEND 
SCOMEF 
SCOPT 

SCRALT 
SCRASH 
SCRATT 
SCRAVL 


000006 
000020 
000012 
000032 
000024 
000012 
000010 
000002 
000050 
000000 
000006 
000022 
000026 
000044 
000046 
016370-R 
006174-R 
016374-R 
007704-R 


007712-R 
007650-R 


007674-R 
006172-R 


017102-R 
016562-R 
075350-R 
007300-R 
034644-R 
034630-R 
007166-R 


007230-R 
007314-R 
013154-R 
016450-R 
010640-R 


010650-R 
006650-R 
034740-R 


006264-R 
002626-R 
010024-R 
010020-R 
006212-R 
020136-R 
006232-R 
014666-R 
016174-R 
006116-R 
006430-R 
006122-R 
006234-R 
001674-R 
001664-R 
036034-R 
006166-R 


Modules That Reference Symbol 


SHE <e sHe tk HE OSE OP OE SE OE te OE 


Se +e Se a& se te 4b St 


$F tH FH 


+e Se 


CROSS-REFERENCES 


EXEDF 
EXEDF 
EXEDF 
SYSDF 
SYSDF 


SYSDF | 


SYSDF 


SYSDF - 


SYSDF 
SYSDF 
SYSDF 
SYSDF 
SYSDF 
SYSDF 
SYSDF 
DRATX 
QUEUE 
DRABO 
ADDRV 
SYSXT 
DROQIO 
DRDSP 
DRMAP 
DRSST 
DREIF 
TDSCH 
DREIF 
DRRES 
ADDRV 
CORAL 
ERROR 
ERROR 
CORAL 
ERROR 
REQSB 
CORAL 
CORAL 
IOSUB 
LOADR 
DBDRV 
IOSUB 
DMDRV 
BFCTL 
DBDRV 
ERROR 
DRQIO 
CRASH 
DRQIO 
DRDSP 
REQSB 
DREXP 
QUEUE 
PARTY 
DRCMT 
SYSCM 
SYSCM 
DRSED 
REQSB 
CRASH 
CRASH 
DRMAP 
CORAL 


TTDRV 
TTDRV 
TTDRV 


DREIF 
SYSCM 
LOADR 
DRATX 


IOSUB 
DRGLI 
DRRAS 
IOSUB 
DRSED 


DRRES 
LOADR 


DRMKT 


PARTY 
DMDRV 
GRDRV 
TTDRV 


DRMAP 


REQSB 
DKDRV 


DRDRV 


DKDRV 
MMDRV 
IOSUB 
PANIC 
GRDRV 
DRMAP 
SYSCM 
LOADR 
SYSCM 
POWER 
QUEUE 


IOSUB 
SYSCM 
EXDBT 
LOWCR 
DRREG 
INITL 


# REQSB 
TDSCH 
PARTY 
DRQTO 


TTDRV 
DRGPP 
DRSED 
POWER 


REQSB 
REQSB 


+ +e 


DRPUT 
POWER 


DREIF 
IOSUB 


DRQIO 


DMDRV 
# IOSUB 
DMDRV 
# SYSCM 


# IOSUB 
DRQTIO 


# REQSB 
TDSCH 


REQSB 


SSTSR 
LOADR 
# SYSCM 


SSTSR 


# REQSB 
# IOSUB 

DRGTK 
# IOSUB 


REQSB 


DRQIO 
LOADR 


DRRAS 
DRDRV 
DRDRV 


SYSTB 


REQSB 
# IOSUB 


# SYSCM 


# PLSUB 


SYSXT 


SSTSR 


DRGTP 


SYSCM 


DRREG 
PLSUB 


DTDRV 


DXDRV 


TTDRV 


Symbol Value 


SCRLF 
SCRPAS 


SCRPBF 
SCRPST 
SCRSBF 
SCRSBN 
SCRSCS 
SCRSHT 
SCRSST 
SCRSUN 
SCRUPC 
SCRUST 
SCURPR 
SCVRTM 
SC5STA 

SDASTT 


SDBINT 
SDBTBL 
$DBO 

SDEACB 


SDEACL 
$DECLK 
SDEPKT 


$DETRG 
SDEUMR 
SDEVHD 
SDEVTB 
SDHINP 
SDHOUT 
SDIRSV 
SDIRXT 
SDIV 


SDKINT 
SDKTBL 
SDPLM1 
$DPLM2 
$DQLM1 
$DQLM2 
$DQUMR 
$DRABO 
SDRASG 
$DRATP 
SDRATR 
$DRATX 
SDRCEF 
SDRCMT 
SDRCRR 
SDRCRW 
SDRCSR 
SDRDAR 
$DRDCP 
SDRDSE 


SDRDTR 
SDREAR 
SDRECP 
SDREIF 


052566-R 
013634-R 


001114-R 
001160-R 
001124-R 
001656-R 
001662-R 
002404-R 
001654-R 
002410-R 
000632-R 
000634-R 
006121-R 
007532-R 
006430-R 
016740-R 


051340-R 
050634-R 
104756-R 
007334-R 


007374-R 
007306-R 
007330-R 


033512-R 
013272-R 
006204-R 
104512-R 
045132-R 
044600-R 
002634-R 
003100-R 
013730-R 


062702-R 
062272-R 
023610-R 
023614-R 
030472-R 
030502-R 
013472-R 
024066-R 
024112-R 
034030-R 
033176-R 
024336-R 
034350-R 
024504-R 
032610-R 
026052-R 
024510-R 
024524-R 
024560-R 
034360-R 


033360-R 
024540-R 
024604-R 
004674-R 


Modules That Reference Symbol 


He te Ee th =e te FE He =H He He te ee HE He SE SE HE 


ste FE 


He =e SE EO OS HE 


He He +e Ae He 4 


CROSS-REFERENCES 


CRASH 
DBDRV 
MMDRV 
CRASH 
CRASH 
CRASH 


CRASH 


CRASH 
CRASH 
CRASH 
CRASH 
CRASH 
CRASH 
REQSB 
CVRTM 
C5STA 

DREIF 
REQSB 
DBDRV 
DBDRV 
SYSTB 
CORAL 
INITL 
CORAL 
CORAL 
CORAL 
IOSUB 
DREIF 
IOSUB 
DRASG 
SYSCM 
TTDRV 
TTDRV 
DRDSP 
INITL 
C5STA 

DRGLI 
DKDRV 
DKDRV 
DRDSP 
DRDSF 
DROIO 
DRQIC 
IOSUEB 
DRABC 
DRASG 
DRDSF 
DRDSF 
DRATX 
DRDSF 
DRCMT' 
DRDSF 
DRDSF 
DRCMT 
DRDAR 
DRDCF 
DRDSF 
DRSED 
DRDSF 
DRDAR 
DRDCF 
DRDSF 


# 


44h 4 4h tk 


PANIC 
DKDRV 


DRDRV 


SYSXT 


DRRAS 


DREIF 
REQSB 


QUEUE 
DRMAP 


TOSUB 


SSTSR 


DKDRV 
INITL 


SSTSR 
SSTSR 
SSTSR 
SSTSR 


DREIF 


DRMAP 
REQSB 


DTDRV 


LOADR 


DRGCL 
SYSXT 


TDSCH 
DRQIO 


# SYSCM 


# SYSXT 


DMDRV 
# IOSUB 


DRRAS 
TDSCH 


# IOSUB 


POWER 


DRREG 
TTDRV 


DRRAS 


DRDRV 


DRRES 


Symbol Value 


SDRELW 
$DREXP 
SDREXT 
$DRFEX 
SDRGCL 
SDRGLI 
$ DRGMX 
$DRGPP 
SDRGSS 
SDRGTK 
SDRGTP 
SDRINT 
SDRLM1 
$DRLM2 
$DRMAP 
SDRMKT 
SDRPUT 
SDRQIO 
$DRQRQ 
SDRRAF 
SDRRCV 
SDRREC 
$DRREQ 
SDRRES 
SDRSPN 
$DRSRF 
$DRSTV 
$DRTBL 
SDRUNM 
$ DRWFL 
SDRWES 
$DRWSE 
$DRO 

$DSO 

SDTINT 
SDTOER 


SDTTBL 
SDTO 

SDVCER 
SDVERR 


$DVMSG 
SDXINT 
SDXTBL 
$DX0 
SDYPMN 
SEDIT 
SEMSST 
SEMTRP 
SERRHD 
SERRLM 
SERRPT 
SERRSQ 
SERRSV 
SERRSZ 
SEXRQF 
SEXROQN 
SEXROQP 
SEXSIZ 
SFINBF 
SFLTRP 


026300-R 
024630-R 
004702-R 
030066-R 
025354-R 
025462-R 
027472-R 
025564-R 
025666-R 
025676-R 
026016-R 
047202-R 
023514-R 
023534-R 
026334-R 
027716-R 
030110-R 
030376-R 
031472-R 
034374-R 
030150-R 
032262-R 
033724-R 
033756-R 
034016-R 
026704-R 
034550-R 
046372-R 
026660-R 
034460-R 
034522-R 
034444-R 
105470-R 
105672-R 
071066-R 
034764-R 


070444-R 
106214-R 
035026-R 
035026-R 


010110-R 
074122-R 
073532-R 
106424-R 
006250-R 
052614-R 
021070-R 
023440-R 
006324-R 
006330-R 
006210-R 
006332-R 
006334-R 
006336-R 
020344-R 
020362-R 
020336-R 
006150-R 
004452-R 
021124-R 


Modules That Reference Symbol 


aH 4 


He 3b 3 


He te SE 


CROSS-REFERENCES 


DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDRV 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DREIF 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
DRDRV 
DRDSP 
DRDSP 
DRDSP 
DRDSP 
SYSTB 
SYSTB 
DTDRV 
DBDRV 
DXDRV 
DTDRV 
SYSTB 
ERROR 
DBDRV 
DXDRV 
DTDRV 
DXDRV 
DXDRV 
SYSTB 
SYSCM 
CRASH 
DRDSP 
DRDSP 
ERROR 
ERROR 
ERROR 
DMDRV 
SYSCM 
ERROR 
IOSUB 
DREIF 
IOSUB 
CORAL 
DREIF 
EXDBT 


He He te HE OE Se SE Oe te SF Se 


+e ste Se He He HE He BE OE EH HE 


SH He HE HE He ate He 


SHe ste He SF + 


DRMAP 
DREXP 
DREIF 
DRPUT 
DRGCL 
DRGLI 
DRMAP 
DRGPP 
DRGSS 
DRGTK 
DRGTP 


EXDBT 
EXDBT 
DRMAP 
DRMKT 
DRPUT 
DRQIO 
DRQIO 
DRSED 
DRPUT 
DRRAS 
DRREQ 
DRRES 
DRRES 
DRMAP 
DRSST 


DRMAP 
DRSED 
DRQIO 
DRSED 


DKDRV 
ERROR 


DRMAP 


SSTSR 
SSTSR 


# DRSED 


DMDRV 
MMDRV 


DMDRV 
MMDRV 
LOADR 


LOWCR 


# SYSCM 


# REQSB 


TDSCH 


DRRAS 


DRDRV 


DRDRV 


LPDRV 


TTDRV 


‘SYSXT 


DTDRV 


DTDRV 


MMDRV 


Symbol Value 


SFMASK 
SFNDSP 
$ FORK 


$FORKO 
$FORK1 
SFPPRQ 
SFPPR7 
SFPPR8 
SFRKHD 
SGRFRK 
SGTWRD 
SHEADR 


SICHKP 
SICINT 
SICTBL 
SIDLCT 
SIDLFL 
SIDLPT 
SILINS 
SINITL 
SINTCT 
SINTSE 
SINTSV 


SINTXT 
SINTX1 
$IOABM 
SIOALT 
SIODON 


SIOFIN 


SIOKIL 
SIOTRP 
SISINT 
SISTBL 
SLCKPR 
SLDPWF 
SLDRPT 
SLOADR 
SLOADT 
$LOGHD 
SLPINT 
SLPTBL 
SLPO 

SLSTLK 
SMAPTK 
$MCRCB 
SMCRPT 
SMMINT 
SMMTBL 
SMMO 

SMPCSR 
SMPCTL 
SMPLND 
SMPLNE 
SMPLUN 
SMPPHY 
SNLO 


006226-R 
017660-R 
002670-R 


002712-R 
002710-R 
021146-R 
021124-R 
021132-R 
006222-R 
000000 

006616-R 
006116-R 


020070-R 
075320-R 
074676-R 
006244-R 
006245-R 
006246-R 
021232-R 
117656-R 
006220-R 
002762-R 
003020-R 


002760-R 
003042-R 
006340-R 
010736-R 
010740-R 


011116-R 


011374-R 
021244-R 
075666-R 
075570-R 
012314-R 
016034-R 
006240-R 
102600-R 
020332-R 
006156-R 
067622-R 
067464-R 
106546-R 
006162-R 
020746-R 
006160-R 
006206-R 
054762-R 
053406-R 
106746-R 
014130-R 
014126-R 
011634-R 
011614-R 
011576-R 
011676-R 
117070-R 


(7ROSS-REFERENCES 


Modules That Reference Symbol 


# SYSCM 
DRREG 
DBDRV 
DXDRV 
IOSUB 
ERROR 
INITL 
POWER 
INITL 

# SYSCM 
GRDRV 

# BFCTL 

DRATX 

LOADR 

SYSXT 

IOSUB 

ICDRV 

ICDRV 

SYSCM 

SYSCM 

SYSCM 

EXDBT 

EXDBT 

SYSCM 

SYSXT 

ERROR 

UDDRV 

NLDRV 

# SYSXT 
DTDRV 

# IOSUB 

DBDRV 

DXDRV 

ADDRV 

ISDRV 

DRASG 

EXDBT 

ISDRV 

ISDRV 

IOSUB 

POWER 

IOSUB 

LOADR 

REQSB 

DRASG 

LPDRV 

LPDRV 

SYSTB 

DREIF 

DREXP 

DRGCL 

QUEUE 

MMDRV 

MMDRV 

SYSTB 

PARTY 

PARTY 

DRASG 

DRETF 

DRASG 

DROQIO 

# SYSTB 


He He te tHe HE 


+6 3 


st te He Se =H: Se Ste Se SF 


He te 3 4 FE 


He te te 


He ste 


REQSB 
DKDRV 
LPDRV 
SSTSR 
GRDRV 
SSTSR 
SSTSR 
SSTSR 
SYSXT 


DRDSP 
PARTY 
SYTAB 
REQSB 


SYSXT 
SYSXT 
SYSXT 
LOWCR 
INITL 
TDSCH 


GRDRV 


ae 


se 4 


DMDRV 
MMDRV 
SYSXT 
SYSXT 


DREIF 
POWER 


SSTSR 


SSTSR 
UDDRV 
SYSCM 


DMDRV 
LPDRV 
GRDRV 
SYSXT 
DROQIO 
SSTSR 


SYSCM 


REQSB 


IOSUB 
IOSUB 
DROQIO 
IOSUB 


DRDRV 


# SYSXT 


TDSCH 


DRRAS 
SSTSR 


# SYSXT 


SYSXT 


DRDRV 
MMDRV 
ICDRV 
TTDRV 
# IOSUB 


# IOSUB 


DTDRV 
TTDRV 


IOSUB 
SYSCM 


TDSCH 


DTDRV 
TTDRV 
IOSUB 
UDDRV 


Symbol 


SNONSI 
SNSO 
SNS1 
SNS2 
SNS3 
SNS4 
SNS5 
SNS6 
$NS7 
SNXTSK 


souT 
SOUTB 
SPANIC 
$PARHD 
SPARPT 
$PARTB 
SPCBS 
SPKAVL 
$PKMAX 
$PKNUM 
SPOOL 
SPOWER 
SPTBYT 
SPTWRD 
SPWRFL 
SQASTT 
SQEMB 
SQINSF 


SQINSP 


SQMCRL 
SQRMVF 


SQRMVT 
$RELOC 


$RELOM 
$RELOP 
$RLMCB 
SRLPAR 
SRLPR1 
$RQSCH 
SSAVNR 
SSCDVT 
S$SCDV1 
SSETCR 
SSETF 

SSRATT 
SSRNAM 
SSRSTD 
SSRWND 
SSTACK 


$STD 

SSTKDP 
$STMAP 
SSTPCT 
SSTPTK 
SSWSTK 
SSYBEG 


Value 


003142-R 
035310-R 
035316-R 
035324-R 
035332-R 
035340-R 
035346-R 
035354-R 
035362-R 
017232-R 


052664=-R 
052660-R 
052562-R 
006236-R 
006230-R 
014034-R 
117426-R 
006410-R 
006413-R 
006412-R 
117552-R 
015664-R 
006570-R 
006616-R 
006152-R 
016772-R 
035526-R 
016242-R 


016250-R 


016306-R 
016316-R 


016330-R 
012764-R 


013034-R 
013554-R 
025416-R 
017156-R 
017220-R 
006200-R 
004620-R 
013050-R 
013054-R 
016614-R 
016674-R 
036134-R 
035654-R 
017042-R 
036172-R 
000632-R 


117462-R 
006202-R 
013316-R 
017132-R 
017136-R 
004640-R 
120756-R 


Modules That Reference Symbol 


INITL 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
ERROR 
DRATX 
REQSB 
CRASH 
CRASH 
PANIC 
PLSUB 
# SYSCM 

INITL 

SYSCM 

CORAL 

CORAL 
# SYSCM 
CORAL 
POWER 
BFCTL 
ADDRV 
POWER 
REQSB 
ERROR 
DRMAP 
IOSUB 
DRQIO 
REQSB 
DREIF 
DREIF 
# QUEUE 
DRRAS 
ADDRV 
TTDRV 
DRATX 
DBDRV 
DREIF 
DREIF 
DRREG 
DRSED 
ERROR 
IOSUB 
IOSUB 
DRRES 
DRRAS 
DRGPP 
DRGPP 
DRDSP 
DRMAP 
CRASH 
SYSXT 
SYSCM 
DRDSP 
DKDRV 
LOADR 
# REQSB 

DRDSP 
# INITL 


+ se 4 $e SE 46 SE te HE 


te 


Se +e 


+e 


se te 


cS He 3 SE SE He +e 3 


+ SE 


ae te 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


CROSS-REFERENCES 


# SYSXT 


DREXP 


TDSCH 


SYSCM 


SYSXT 
TTDRV 
PARTY 
DRRES 


# QUEUE 


LOADR 


TTDRV 
DRRES 


DRRES 
GRDRV 


# IOSUB 


DRDRV 


# REQSB 


REQSB 
LOADR 
TDSCH 


IOSUB 


# REQSB 


DRREG 


# PLSUB 


INITL 


SSTSR 
DTDRV 


+e 4b 


DRRES 


POWER 
ERROR 
REQSB 
PLSUB 
LOADR 


QUEUE 
IOSUB 


SSTSR 
IOSUB 


SYSCM 
REQSB 


REQSB 


PLSUB 


LOWCR 


SYSCM 
IOSUB 


IOSUB 


GRDRV 


QUEUE 


REQSB 
SYSXT 


SYSXT 


SYSXT 


SYSAT 


SSTSR 


SYSXT 


Symbol Value 


SSYSID 
SSYSIZ 
SSYTOP 
$SYUIC 
STKNPT 
STKPS 


STKTCB 


STKWSE 
STRACE 
STRPO4 
STRTRP 
STSKHD 
STSKRP 
STSKRQ 
STSKRT 
STSTCP 
STTNS 
STTTBL 
STTO 
SsTT1 
STT1O 
STT11 
$TT12 
$TT13 
STT14 
STT15 
STT16 
STT17 
STT2 
STT20 
$TT21 
STT22 
STT23 
S$TT24 
$TT25 
STT26 
$TT27 
$TT3 
$TT30 
$TT31 
$TT32 
$TT33 
$TT34 
$TT35 
$TT36 
$TT37 
STT4 
STT40 
STT41 
STT42 
$TT43 
STT44 
STT45 
STT46 
STT47 
STT5 
STT50 
$TT51 
STT52 


006126-R 
006342-R 
124756-R 
006144-R 
006132-R 
006370-R 


006176-R 


034440-R 
021324-R 
021336-R 
023374-R 
006242-R 
020414-R 
020412-R 
020406-R 
017762-R 
006406-R 
044570-R 
107130-R 
114556-R 
115046-R 
115076-R 
115126-R 
115156-R 
115206-R 
115236-R 
115266-R 
115316-R 
114626-R 
115346-R 
115376-R 
115426-R 
115456-R 
115506-R 
115536-R 
115566-R 
115616-R 
114656-R 
115646-R 
115676-R 
115726-R 
115756-R 
116006-R 
116036-R 
116066-R 
116116-R 
114706-R 
116146-R 
116176-R 
116226-R 
116256-R 
116306-R 
116336-R 
116366-R 
116416-R 
114736-R 
116446-R 
116476-R 
116526-R 


CROSS-REFERENCES 


Modules That Reference Symbol 


EXDBT INITL # SYSCM 
INITL # SYSCM 

INITL SYSCM 

SYSCM 

DREI?f IOSUB REQSB 
CVRTM DRGTP INITL 
‘TTDRV 

DRDS?P DREIF DRQIO 
LOADR PARTY REQSB 
SYSXT 

DREIF DRQIO 
EXDBT LOWCR SSTSR 
EXDBT LOWCR SSTSR 
# DRDSP EXDBT LOWCR 
REQSB # SYSCM 

DRREQ # REQSB 

REQSB 

ERROR # REQSB TDSCH 
REQSB 

DRGTP ERROR PARTY 
TTDRV 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 

SYSTB 


+e 4 


DRSED 


+e te 


He He ste HE te He SHE He ote HE HE ER OSE SHE OSE EOS Oe OE OSE te POF OSE OE SE SE OSE He SE EO OO SE i EE Ed se 


# SYSCM 
# SYSCM 


DRSED 
SSTSR 


LOADR 


# SYSCM 


TDSCH 


IOSUB 
# SYSCM 


TDSCH 


CROSS~REFERENCES 


Symbol Value Modules That Reference Symbol 
STT53 116556-R # SYSTB 
STT54 116606-R # SYSTB 
$TT55 116636-R # SYSTB 
STT56 116666-—-R # SYSTB 
$TT57 116716-R # SYSTB 
STT6 114766-R # SYSTB 
STT60 116746-R # SYSTB 
$TT7 115016-R # SYSTB 
SUDINT 050560-R # UDDRV 
SUDTBL 050472-R # UDDRV 


SUISET 020706-R DRMKT DRREQ # REQSB 


SUMRHD 006416-R IOSUB # SYSCM 
SUMRWT 006424-R IOSUB # SYSCM 
SUNMAP 036232-R DRMAP DRREG # PLSUB 
SUSRTB 000000 SYSTB 

SWTUMR 013516-R # IOSUB 

$XDT 076362-R # EXDBT 

.~CLO 117220-R # SYSTB 

-co0 117174-R SYSCM # SYSTB 
. DBO 104552-R # SYSTB 

-DB1 104612-R # SYSTB 

~DB2 104652-R # SYSTB 

-DB3 104712-R # SYSTB 

.DKO 105054-R # SYSTB 

.DK1 105114-R # SYSTB 

.DK2 105154-R # SYSTB 

-DTO 105770-R # SYSTB 

.DT1 106034-R # SYSTB 

~DT2 106100-R # SYSTB 

.DT3 106144-R # SYSTB 

-DX0 106320-R # SYSTB 

-DX1 106360-R # SYSTB 

- LBO 117244-R INITL # SYSTB SYTAB 
~ LDR 117462-R SYSCM # SYTAB 
. LDRHD 117302-R # SYTAB 

LPO 106514-R #€ SYSTB 

-MMO 106636-R # SYSTB 

~MM1 106700-R # SYSTB 

»NLO 117036-R # SYSTB 

-SY0 117270-R INITL # SYSTB SYTAB 
-TIO 117150-R # SYSTB 

-TTO 107046-R # SYSTB 

-TT1 107222-R # SYSTB 

-TT10 110050-R # SYSTB 

-TT11 110142-R # SYSTB 

TT12 110234-R # SYSTB 

-TT13 110326-R # SYSTB 

-TT14 110420-R # SYSTB 

-TT15 110512-R # SYSTB 

-TT16 110604-R # SYSTB 

-TT17 110676-R # SYSTB 

-TT2 107314-R # SYSTB 

-TT20 110770-R # SYSTB 

-TT21 111062-R # SYSTB 

-TT22 111154-R # SYSTB 

-TT23 111246-R # SYSTB 

.TT24 111340-R # SYSTB 

-TT25 111432-R # SYSTB 

.TT26 111524-R # SYSTB 

~TT27 111616-R # SYSTB 

-TT3 107406-R # SYSTB 

-TT30 111710-R # SYSTB 


CROSS-REFERENCES 


Symbol Value Modules That Reference Symbol 
PT SL 112002-R # SYSTB 
-TT32 112074-R # SYSTB 
-TT33 112166-R # SYSTB 
~TT34 112260-R # SYSTB 
eIT35 112352-R # SYSTB 
-TT36 112444-R # SYSTB 
-TT37 112536-R #-SYSTB 
-TT4 107500-R # SYSTB 
~TT40 112630-R # SYSTB 
-TT41 112722-R # SYSTB 
sPT5 107572-R # SYSTB 
.TT50 113550-R # SYSTB 
-TT51 113642-R # SYSTB 
~TT52 113734-R # SYSTB 
.TT53 114026-R # SYSTB 
~TT54 114120-R # SYSTB 
-TT55 114212-R # SYSTB 
-TT56 114304-R # SYSTB 
~TT57 114376-R # SYSTB 
~TT6 107664-R # SYSTB 
-TT60 114470-R # SYSTB 
sTT? 107756-R # SYSTB 


9.3  MCRMU GLOBAL CROSS-REFERENCE 
This cross-reference is for a mapped system. 


The cross-reference contains an alphabetic listing of each global 
symbol along with its value and the name of each referencing module. 
When a symbol is defined in several segments within an _ overlay 
structure, TKB prints the last defined value in the listing. 
Similarly, in a real TKB cross-reference listing, TKB would print the 
module mame more than once for each symbol if the module is loaded in 
several segments within the structure. 


The Task Builder creates an MCRMU.CRF cross-reference file when /CR is 
specified in the Task Builder command file used to build MCRMU. One 
of the input files to the Task Builder when building MCRMU is’ the 
Executive symbol table file, RSX11M.STB. RSX11M.STB is needed because 
MCRMU) references some Executive symbols. All the symbols’ from 
RSX11M.STB are put in the MCRMU.CRF symbol table file even though they 
are not referenced by MCR. Therefore, some symbols appearing here in 
the MCRMU cross-reference are defined in the Executive but not used by 
MCRMU. These symbols are shown defined in the Executive LOWCR or 
EXEDF modules. 


The value contains the suffix -R if the symbol is relocatable. 


Prefix symbols accompanying 


CROSS-REFERENCES 


each module name define the 


type 


reference as follows: 


Prefix 
Symbol 


blank 


Symbol 


C.SCHD 
DV.PSE 
DV .TTY 
DV.UMD 
DSSYNM 
D.DSP 
D.LNK 
D.MSK 
D.NAM 


D.PCB 

D.RSOO 
D.RS1 

D.RS1O 
D.RS16 
D.RS17 
D.RS19 
D.RS2 

D.RS22 
D.RS5 

D.RS6 

D.RS7 

D.RS8 

D.RS80 
D.RS81 
D.RS84 
D.RS85 
D.RS86 
D.RS87 
D.RS90 
D.RS92 
D.RS93 
D.RS94 
D.RS95 
D.RS96 
D.RS97 
D.RS98 
D.RS99 
D.UCB 


Reference Type 


Module contains a reference that is resolved in the 
game segment or in a segment toward the root. 


Module contains a reference that is resolved 
directly in a segment away from the root or in a 
co-tree. 
Module contains a reference that is resolved 
through an autoload vector. 
Module contains a non-autoloadable definition. 
This module defines the symbol. 
Module contains an autoloadable definition. This 
module defines the symbol. 
Value Modules That Reference Symbol 

000002 # EXEDF FIXOV 

010000 # EXEDF # LOWCR 

000004 # EXEDF # LOWCR 

000200 # EXEDF # LOWCR 

000000 # LOWCR 

000012 # EXEDF # LOWCR 

000000 # EXEDF FIXOV 

000014 # EXEDF # LOWCR 

000004 # EXEDF FIXOV FMTDV GTTSK # LOWCR 

MCRDIS 

000034 # EXEDF # LOWCR 

000000 # LOWCR 

177777 # LOWCR 

177766 # LOWCR 

177760 # LOWCR 

177757 # LOWCR 

177755 # LOWCR 

177776 # LOWCR 

000002 # LOWCR 

177773 # LOWCR 

177772 # LOWCR 

177771 # LOWCR 

177770 # LOWCR 

177660 # LOWCR 

177657 # LOWCR 

177654 # LOWCR 

177653 # LOWCR 

177652 # LOWCR 

177651 # LOWCR 

177646 # LOWCR 

177644 # LOWCR 

177643 # LOWCR 

177642 # LOWCR 

177641 # LOWCR 

177640 # LOWCR 

177637 # LOWCR 

177636 # LOWCR 

177635 # LOWCR 

000002 # EXEDF FIXOV FMTDV GTMNM # LOWCR 


Symbol Value 


D.UCBL 
D.UNIT 
D.VCAN 
D.VINI 
D.VOUT 
D.VPWF 
EC.DTO 
EC.DVC 
EC.NSI 
E.LGTH 
E.OPC 

E.RTRY 
E.SIZE 
FE.CAL 
FE .MUP 
FE.MXT 
FE.PLA 
H.HDLN 
H.LUN 

H.WND 

IE.ABO 
IE.ALN 
IE.BAD 
IE.BLK 
IE.BYT 
IE.DAA 
IE.DNA 
IE.DNR 
IE.EOF 
IE.IFC 
IE.LCK 
IE.NLN 
IE.NOD 
IE.OFL 
IE.OVR 
IE.PRI 
IE.SPC 
IE.ULK 
IO.ATT 
IO.CLN 
IO.DET 
IO.KIL 
IO.LOV 
IO.NLK 
IO.RLB 
IO.RVB 
IO.ULK 
IO.WLB 
IO.WVB 
IQ.UMD 
IS.SUC 
KISAR5 
KISAR6 
L.ASG 

L.NAM 

L.TYPE 
L.UCB 

L.UNIT 
MS-‘SMGE 
P.ATT 

P.BLKS 
P.BUSY 


000010 
000006 
000002 
000000 
000004 
000006 
000140 
000001 
000141 
000056 
000022 
000016 
000000 
000040 
000002 
040000 
000020 
000002 
000076 
000044 
177761 
177736 
177777 
177754 
177755 
177770 
177771 
177775 
177766 
177776 
177745 
177733 
177751 
177677 
177756 
177760 
177772 
177653 
001400 
003400 
002000 
000012 
001010 
011400 
001000 
010400 
005000 
000400 
011000 
000004 
000001 
172352 
172354 
000010 
000002 
000005 
000006 
000004 
000000 
000036 
000016 
000024 


Modules That Reference Symbol 


+ He te SH OE 46 Se Se Se te FE FE SHE SHE ORE SH HE OE OEE OHO HO SHE ESE SE HOS OS SOS HE HE FE 


aie He SHE He OE HE SHE SHES SE HE HE ste 4 


CROSS-REFERENCES 


EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
MCRDIS 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LN1OV 
LOWCR 
LOWCR 
ERROV 
LOWCR 
FIXOV 
LN1OV 
LOWCR 
LOWCR 
LOWCR 
ERROV 
LOWCR 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
FIXOV 
EXEDF 
EXEDF 


Se Se Fe SE te OE EE FE 


SH: He ste Se Sb SE SE SE SE FE 


FIXOV 
FIXOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
MCRDIS 
FIXOV 
MCRDIS 
FIXOV 
FIXOV 
FIXOV 
MCROOT 


LOWCR 


LUNOV 
MCRDIS 


LOWCR 


LN1OV 


LOWCR 
LOWCR 
LOWCR. 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 


FMTDV 
FMTDV 


MCRDIS 


MCRDIS 


# LOWCR 


GTMNM 
GTMNM 


MCRDIS 


# LOWCR 
# LOWCR 


Symbol Value 


P.HDR 
P.IOC 
P.LGTH 
P.LNK 
P.MAIN 
P.NAM 
P .OWN 
P.PRI 
P.PRO 
P.REL 
P.SIZE 
P.STAT 
P.SUB 
P.SWSZ 
P.TCB 
P.WAIT 
SP.EIP 
SP .ENB 
S.BMSK 
S.BMSV 
S.CCB 
S.CON 
S.CSR 
S.CTM 
S.DZCK 
S.FRK 
S.ITM 
S.LHD 
S.MPR 
S.PKT 
S.PRI 
S.RCNT 
S.ROFF 
S.STS 
S.VCT 
TS .EXE 
Ts .OUT 
T.ACTL 
T.ATT 
T.CPCB 
T.DPRI 
T.EXT 
T.LGTH 
T.MXSZ 
T.NAM 
T.OFF 
T.PCB 
T.PRI 
T.RCVL 
T.RRFL 
T.STAT 
T.ST2 
T.ST3 
T.TCBL 
T.UCB 
T2.ABO 
T2.BFX 
T2.CHK 
T2.CKD 
T2.FXD 
T3.ACP 
T3.MCR 


000032 
000003 
000042 
000000 
000012 
000004 
000026 
000002 
000034 
000014 
000016 
000030 
000010 
000022 
000026 
000020 
000001 
000002 
177776 
177774 
000030 
000010 
000012 
000006 
000030 
000016 
000007 
000000 
000030 
000014 
000004 
177772 
177773 
000011 
000005 
100000 
000400 
000052 
000054 
000004 
000040 
000000 
000070 
000050 
000006 
000060 
000046 
000002 
000012 
000064 
000032 
000034 
000036 
000030 
000026 


"000100 


004000 
020000 
010000 
002000 
100000 


004000 


Modules That Reference Symbol 


oH: He He He He + sie He He =H He HR SHE OE Se SE SE HE te EE OSE OS OE SE te te te He SE He HE SIE Sb OE Se OE SE EOE SE te FE th 


He ste “He OE OE 


CROSS-REFERENCES 


FIXOV 
EXEDF 
FIXOV 
EXEDF 
EXEDF 


' EXEDF 


EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDP 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
FIXOV 
EXEDF 
ABOOV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
ABOOV 
ABOOV 
ABOOV 
EXEDF 
ABOOV 
ABOOV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 


Se St He SE OE SE 6 +e Se +e =e th He ste He AE OSE EE HE He He ste Se Oe te AE SE 


te Se oe Sr te 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR — 


FIXOV 
FIXOV 
MCRDIS 
FIXOV 
MCRDIS 
MCRDIS 


LOWCR 
FIXOV 
EXEDF 
MCRDIS 
FIXOV 
MCRDIS 
FIXOV 
FIXOV 
EXEDF 
EXEDF 
EXEDF 
FIXOV 
EXEDF 
EXEDF 
FIXOV 
FIXOV 
LKLST 
FIXOV 
MCRDIS 
MCRDIS 


MCRDIS 
MCRDIS 


MCRDIS 
FIXOV 
LKLST 
MCRDIS 
FIXOV 
FIXOV 
FIXOV 


MCRDIS 
GTMNM 


MCRDIS 


MCRDIS 


MCRDIS 
LKLST 
MCRDIS 


GTTSK 


MCRDIS 


MCRDIS 


Symbol 


T3.PMD 
T3.PRV 
T3.REM 
T3.RST 
T3.SLV 
UC.ATT 
UC. KIL 
UC.LGH 
UC.NPR 
UC.PWE 
UC.QUE 
UISARO 
UISDRO 
US.BSY 
US.FOR 
US.MDM 
US.MNT 
US .OFL 
US.PUB 
US.UMD 
U.ACP 
U.ATT 
U.BUF 
U.CNT 
U.CTL 
U.CWl 
U.CW2 
U.CW3 
U.CW4 
U.DCB 
U.LUIC 
U.OWN 
U.RED 
U.SCB 
U.STS 
U.ST2 
U.UIC 
U.UNIT 
U.VCB 
U2.AT. 
U2.HLD 
U2.LOG 
U2.PRV 
VSSCTR 
W.BLVR 
X.AST 
X.DSI 
X. FORK 
X.ISR 
X.JSR 
X.LEN 
X.LNK 
X.PSW 
X.REL 
X.TCB 
X.VEC 
X.VPC 
SABCTK 
SABOEP 
SABTIM 
SABTSK 
SACHCK 


Value 


040000 
010000 
020000 
000400 
002000 
000010 
000004 
000003 
000100 
000020 
000040 
177640 
177600 
000200 
000040 
000020 
000100 
000001 
000004 
000010 
000032 
000022 
000024 
000030 
000004 
000010 
000012 
000014 
000016 
000000 
177774 
177776 
000002 
000020 
000005 
000007 
000052 
000006 
000034 
000020 
000040 
000400 
000010 
000410 
000002 
000032 
000024 
000012 
000010 
000002 
000050 
000000 
000006 
000022 
000026 
000044 
000046 
014460 


122036-R 


005414 
014464 
007242 


Modules That Reference Symbol 


# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


(CROSS-REFERENCES 


EXEDF 
ABOOV 
EXEDF 
EXEDF 
ABOOV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
ABOOV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
ABOOV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
ABOOV 
LOWCR 
EXEDF 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ABOOV 
LOWCR 
ABOOV 
LOWCR 


Se Se Se SE eS Oe OS OE OE ESE HE FEE HE SE REE SE EE 


te Se SH Se SH OE 


# 


MCRDIS 
EXEDF 
FIXOV 
MCRDIS 
EXEDF 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
EXEDF 
LOWCR 
MCRDIS 
FMTDV 
MCRDIS 
LOWCR 
EXEDF 
LOWCR 
LOWCR 
LOWCR 
MCRDIS 
LOWCR 
LOWCR 
MCRDIS 
MCRDIS 
FIXOV 
EXEDF 


MCROOT 


PR1LOV 


LOWCR 


MCRDIS 
MCRDIS 


FIXOV 


GTMNM 


GTMNM 


MCRDIS 
FIXOV 


# LOWCR 


GTTSK 


# LOWCR 


MCRDIS 


MCRDIS 


' MCRDIS 


MCRDIS 


Symbol Value 


SACHKB 
SACHKP 
SACHKW 
SACTHD 
SACTRM 
SACTTK 
SALCLK 
SALEB1 
SALEMB 
SALOCB 
SALOCL 
SALPKT 
SBILDS 
SBLKCK 
SBLKC1l 
SBLXIO 
SBMSET 
SBTMSK 
SCANEP 
SCAT5 
$CBDMG 
$CBOMG 
SCEFI 
SCEFN 
SCFLPT 
SCHKPT 
SCKACC 
SCKCNT 
SCKCSR 
SCKINT 
S$CKLDC 
SCLINS 
SCLKHD 
SCLRMV 
SCOMEF 
SCOPT 
SCRASH 
SCRATT 
SCRAVL 
SCRPAS 
SCRSBF 
$CRSBN 
SCRSCS 
SCRSHT 
SCRSST 
SCRSUN 
SCVRTM 
SC5TA 
SDASTT 
$ DBO 
$DEACB 
$DEAC1 
SDECLK 
SDEPKT 
SDETRG 
$SDEVHD 
$DEVTB 
SDIRSV 
SDIRXT 
SDIV 
$DKO 
SDPLM1 


007250 
007206 
007232 
005634 
015172 
014652 
006636 
032634 
032620 
006524 
006566 
006652 
014540 
010174 
010204 
006212 
032730 
005640 


122122-R 


125444 
123250 
123264 
007362 
007356 
005522 
016226 
033726 
005604 
005606 
017726 
005610 
014162 
005556 
014264 
005570 
005560 
001470 
034024 
005532 
012470 
000730 
001462 
001466 
001752 
001460 
001756 
007070 
005772 
015030 
043366 
006672 
006732 
006644 
006666 
031502 
005462 
043122 
002264 
002514 
012564 
043630 
021662 


CROSS-REFERENCES 


Modules That Reference Symbol 


# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


He =H oe + SHB HE =H HE OE te EC EE EC SE EE He He te oe SF SE OE OE SHE HE SE 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
FIXOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ABOOV 
GTTSK 
LUNOV 
FMTDV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
PIXOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ERROV 
LOWCR 
LOWCR 
FIXOV 
LOWCR 
LOWCR 
FIXOV 
FIXOV 
PIXOV 
LOWCR 
LOWCR 
LOWCR 
FMTDV 
LOWCR 
LOWCR 


# LOWCR 


PRLOV 


MCRDIS 


GTMNM 


, 


# LOWCR 


# LOWCR 


# LOWCR 


LOWCR 
LOWCR 
LOWCR 


Se Ae =e 


GTMNM 


9-35 


MCRDIS 


PRLOV 


MCRDIS 


# LOWCR 


CROSS-REFERENCES 


Symbol Value Modules That Reference Symbol 


SNPLM2 021666 # LOWCR 
SDQLM1 026526 # LOWCR 
$DQLM2 026536 # LOWCR 
SDRABO 022140 # LOWCR 
SDRASG 022164 # LOWCR 
SDRATP 032020 ABOOV # LOWCR 
. SDRATR 031166 # LOWCR 
SDRATX 022410 # LOWCR 
SDRCEF 032340 # LOWCR 
SDRCMT 022556 # LOWCR 
SDRCRR 030600 # LOWCR 
SDRCRW . 024064 # LOWCR 
SDRCSR 022562 # LOWCR 
SDRDAR 022576 # LOWCR 
$DRDCP 022632 EDCKP # LOWCR 
SDRDSE 032350 LKLST # LOWCR 
SDRDTR 031350 # LOWCR 
SDREAR 022612 # LOWCR 
$DRECP 022656 EDCKP # LOWCR 
SDREIF 004220 # LOWCR 
SDRELW 024312 # LOWCR 
$DREXP 022702 # LOWCR 
SDREXT 004226 # LOWCR MCRDIS 
S$ DRFEX 026100 # LOWCR 
$DRGCL 023372 # LOWCR 
SDRGLI 023500 # LOWCR 
$DRGMX 025504 # LOWCR 
$DRGPP 023602 # LOWCR 
SDRGSS 023704 # LOWCR 
$DRGTK 023714 # LOWCR 
SDRGTP 024030 # LOWCR 
SDRLM1 021566 # LOWCR 
$DRLM2 021606 # LOWCR 
SDRMAP 024346 # LOWCR 
SDRMKT 025730 # LOWCR 
SDRPUT 026122 # LOWCR 
SDRQIO 026410 # LOWCR 
$DRQROQ 027516 # LOWCR 
SDRRAF 032364 # LOWCR 
SDRRCV 026162 # LOWCR 
SDRREC 030306 # LOWCR 
SDRREQ 031714 # LOWCR 
$DRRES 031746 # LOWCR 
SDRRRA 026142 # LOWCR 
SDRRRF 025232 # LOWCR 
$DRRUN 025762 # LOWCR 
$SDRSDV 032532 # LOWCR 
SDRSEF 032420 # LOWCR 
SDRSND 030440 # LOWCR 
SDRSPN 032006 # LOWCR 
SDRSRF 024716 # LOWCR 
SDRSTV 032540 # LOWCR 
$DRUNM 024672 # LOWCR 
$SDRWFL 032450 # LOWCR 
SDRWFS 032512 # LOWCR 
SDRWSE 032434 # LOWCR 
SDSW 000046 ABOOV 
SDSO 044064 # LOWCR 
SDTOER 032754 # LOWCR 
$DTO 044276 # LOWCR 
SDVCER 033016 # LOWCR 
SDVERR 033016 # LOWCR 


Symbol Value 


SDVMSG 
$Dx0 
SDYPMN 
SEMSST 
SEMTRP 
SERREP 
SERRHD 
SERRLM 
SERRLN 
SERRPT 
SERRSQ 
SERRSV 
SERRSZ 
SERRTB 
SEXROQF 
SEXROQN 
SEXROQP 
SEXSIZ 
SPINBF 
SFIXEP 
SFLTRP 
SPMASK 
SFMTDV 
SFNDSP 
$FORK 
$FORKO 
$FORK1 
SFPINT 
SFRKHD 
$SGNBLK 
SGTBYT 
SGTMNM 
SGTPKT 
SGTTSK 
SGTWRD 
SHEADR 


$ICHKP 
SILINS 
SINITL 
SINTCT 
SINTSE 
SINTSV 
SINTXT 
SINTX1 
$IOABM 
SIOALT 
SIODON 
SIOFIN 
SIOKIL 
SIOTRP 
SLCKPR 
SLDPWF 
SLDRPT 
SLNLEP 
SLOAD 
$LOADR 
SLOADT 
SLOCKL 
$LOGHD 
SLPO 
SLSTLK 


007446 
044472 
005470 
017156 
021512 


121660-R 


005700 
005704 
000404 
005514 
005706 
005710 
005712 


124064-R 


016434 
016452 
016426 
005520 
003776 


122714-R- 


017212 
005552 


123156-R 


015750 
002320 
002342 
002340 
017226 
005546 


125270-R 


006102 


125340-R 


007510 


124714-R 


006160 
005564 


016160 
017304 
052414 
005542 
002376 
002434 
002374 
002456 
005714 
010272 
010274 
010414 
010666 
017316 
011552 
014124 
005464 


124436-R 


121004 
041214 
016422 


_ 125120-R 


005624 
044614 
005630 


Modules That Reference Symbol 


Sd Se SH OE OE RE OS OE SE OSE OE OE He He EOE AE OSE OSE OE SR Ae HE ste “46 Se te te te Ae SE SE 


CROSS-REFERENCES 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ERROV 
LOWCR 
LOWCR 
ERRMSG 
FIXOV 
LOWCR 
LOWCR 
LOWCR 
ERRMSG 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
FIXOV 
LOWCR 
FIXOV 
FMTDV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
GNBLK 
LOWCR 
GTMNM 
LOWCR 
ABOOV 
LOWCR 
FIXOV 


MCROOT 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LN1OV 
MCROOT 
LOWCR 
LOWCR 
FIXOV 
LOWCR 
LOWCR 
LKLST 


ERROV 
# LOWCR 


ERROV 


PR1OV 


# LOWCR 
LUNOV 


GTTSK 
FIXOV 


GTTSK 


PR1OV 


# LKLST 


# LOWCR 


MCRDIS 


MCRDIS 


# GTTSK 


GKLST 


MCRDIS 


LNLOV 


LN1LOV 


# LOWCR 


Symbol Value 


SLUNEP 
SMAPTK 
SMBUF 
SMCKD 
SMCKE 
SMCMD 


SMCOV 
SMCR 
SMCRCB 
SMCRPT 
SMDIS 
SMDPB 


$MERLD 


SMERR 
SMERRN 


SMLDOV 
SMLIMI 
SMLINE 
SMMO 

SMOVRB 
SMPARS 


SMPCSR 
SMPLND 
SMPLNE 


SMPLUN . 


SMPPHY 
SMPPKT 
SMPRSR 
SMPVBN 
SMROOT 
SMTERM 
$MUCB 
SMUL 
SMXEXT 
SNLO 
SNNBLK 
SNONSI 
SNSO 
SNS1 
SNS2 
SNS3 
SNS4 
SNS5 
SNS6 
SNS7 
SNULL 
SNXTSK 
SOVEP 
SPANIC 
$PARHD 
SPARPT 
$PARTB 
SPCBS 
$PKAVL 
SPKMAX 
SPKNUM 
SPOOL 


122636-R 
017036 

120362-R 
122212=-R 
122224-R 
120454-R 


120464-R 
120634-R 
005626 
005466 
120500-R 
120366-R 


120720-R 


120470-R 
120474-R 


120724-R 
120632-R 
120504-R 
045014 

120416-R 
120424-R 


012734 
011126 
011106 
011070 
011170 
011240 
120460-R 
011372 
120706-R 
120476=-R 
120364-R 
012534 
005770 
051622 
125272-R 
002556 
033300 
033306 
033314 
033322 
033330 
033336 
033344 
033352 
043100 
015322 
121634-R 
001470 
005422 
005554 
012670 
052164 
005764 
005767 
005766 
052310 


(CROSS-REFERENCES 


Modules That Reference Symbol 


# 
# 
# 
# 


se =H se te 


Se Se 3b Se 3 4 HE 


SHE HE Se SE EE HE SE HE FE Se SE He OE SE OE te HE HE SE EO 


LUNOV 
LOWCR 
ERROV 
EDCKP 
EDCKP 
ERROV 
PR1OV 
MCRDIS 
ABOOV 
LOWCR 
FIXOV 
MCROOT 
ABOOV 
MCRDIS 
ABOOV 
MCROOT 
MCROOT 
ABOOV 
MCRDIS 
LN1OV 
MCROOT 
MCRDIS 
LOWCR 
MCROOT 
ABOOV 
MCRDIS 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
MCRDIS 
LOWCR 
MCROOT 
MCRDIS 
ABOOV 
LOWCR 
LOWCR 
LOWCR 
GNBLK 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
FIXOV 
MCRDIS 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LN10V 
ERROV 
ERROV 
FIXOV 


# MCROOT 
ERROV 
MCRDIS 

# LOWCR 


ERROV 


# MCROOT 


FIXOV 
PR1OV 


ERROV 


# MCROOT 
MCRDIS . 


# MCROOT 


ERROV 


# MCROOT 


# MCROOT 


# MCROOT 
FIXOV 


PR1OV 


# LOWCR 
“ MCROOT 


LUNOV 
MCRDIS 
MCRDIS 
LN1OV 


PR1OV 
FIXOV 


FIXOV 


LN1OV 


FIXOV 
PR1OV 
MCROOT 


FIXOV 
PR1LOV 


LN1OV 


MCRDIS' # 
MCRDIS”) # 
LUNOV # 
LN1OV 
LUNOV 
LNLOV 
LN1OV 
MCRDIS' # 


MCROOT 


MCROOT 


MCROOT 


LUNOV 


MCRDIS 


LUNOV 


LUNOV 


MCROOT 


Symbol Value 


SPOWER 
SPPO 
SPRO 
SPRIEP 
SPTBYT 
SPTWRD 
SPWRFEL 
SQASTT 
SQEMB 
SQINSF 
SQINSP 
SQMCRL 
SQRMVF 
SQRMVT 
SRELOC 
$RELOM 
$RELOP 
$REMEP 
SRESEP 
$SRLMCB 
SRLPAR 
SRLPRI1 
$ROSCH 
SSAVNR 
SSCDVT 
SSCDV1 
SSETCR 
SSETF 
SSETM 
SSETRQ 
SSETRT 
SSGFLT 
SSHFPT 
SSIGFL 
SSRATT 
SSRNAM 
SSRSTD 
SSRWND 
$STACK 
SSTD 
SSTKDP 
SSTPCT 
SSTPTK 
SSWSTK 
SSYBEG 
SSYSID 
SSYSIZ 
SSYTOP 
SSYUIC 
STKNPT 
STKPS 
STKTCB 


STKWSE 
STRACE 
STRPO04 
STRTRP 
STSKHD 
STSKRP 
STSKRQ 
STSKRT 
STSTCP 


013750 
045144 
045266 
121654-R 
006132 
006160 
005416 
015062 
033516 
014332 
014340 
014376 
014406 
014420 
012222 
012272 
012410 
122714-R 
122134-R 
023434 
015246 
015310 
005452 
004144 
012306 
012312 
014704 
014762 
014766 
014734 
014732 
017336 
005516 
005420 
034124 
033644 
015132 
034162 
000642 
052220 
005454 
015222 
015226 
004164 
053424 
005574 
005716 
063424 
005612 
005600 
005744 
005446 


032430 
017376 
017410 
021446 
005512 
016504 
016502 
016476 
016052 


CROSS-REFERENCES 


Modules That Reference Symbol 


LOWCR 
LOWCR 
LOWCR 
PR1OV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
FIXOV 
LOWCR 
FIXOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
FIXOV 
ABOOV 
LOWCR 
FIXOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
FIXOV 
LKLST 
# LOWCR 
# LOWCR 
GTTSK 
# LOWCR 
# LOWCR 
# LOWCR 
# LOWCR 
# LOWCR 
# LOWCR 
# LOWCR 
# LOWCR 
# LOWCR 
# LOWCR 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


46 oe He AE Sh Se SE OSE Se te oH te + te SE SE ste tHe He He OR ste Se HE tHE HE Se 


LOWCR 
LOWCR 
FIXOV 
LOWCR 
ABOOV 
LOWCR 
LKLST 
LOWCR 
LOWCR 
LOWCR 
FIXOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 


LOWCR MCRDIS 


PR1OV 
PR1OV 


LOWCR 


LOWCR 
LOWCR 


LOWCR MCRDIS 


MCRDIS 


LOWCR 


EDCKP 
MCRDIS 
LOWCR 


GTMNM GTTSK LKLST 


LOWCR 
MCRDIS 


CROSS-REFERENCES 


Symbol Value Modules That Reference Symbol 
STINS 005762 LOWCR 
$TTO 045534 LOWCR 
$TT1 045564 LOWCR 
$TT10 047672 LOWCR 
$TT11 047722 LOWCR 
$TT12 047752 LOWCR 
$TT13 050002 LOWCR 
STT14 050032 LOWCR 
STT15 050062 LOWCR 
STT16 050112 LOWCR 
$TT17 050142 LOWCR 
$TT2 047452 LOWCR 
$TT20 050172 LOWCR 
$TT21 050222 LOWCR 
$TT22 051210 LOWCR 
$TT23 051260 LOWCR 
S$TT24 051310 LOWCR 
$TT25 051340 LOWCR 
STT26 051370 LOWCR 
$TT27 051420 LOWCR 
$TT3 047502 LOWCR 
STT30 051450 LOWCR 
$TT31 051500 LOWCR 
$TT4 047532 LOWCR 
$TT5 047562 LOWCR 
$TT6 047612 LOWCR 


$TT7 047642 
SUISET 016776 
SUNFEP 122714-R FIXOV PRIOV 

SUNLKL 125210-R FIXOV # LKLST MCRDIS 


# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# 

# LOWCR 
# 
# 

SUNMAP 034222 # LOWCR 

# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


LOWCR 


SUSRTB 000000 LOWCR 
$XDT 035002 LOWCR 
CLO 051756 LOWCR 
-CO0 051732 LOWCR 
- DBO 043162 LOWCR 
-DB1 043222 LOWCR 
-OB2 043262 LOWCR 
083 043322 LOWCR 
- DKO 043464 LOWCR 
-DK1 043524 LOWCR 
»DK2 043564 LOWCR 
-DSW 000044 LOWCR 
- DSO 043720 LOWCR 
-DS1 043760 LOWCR 
-DS2 044020 LOWCR 
-DTO 044162 LOWCR 
~DT1 044226 LOWCR 
« DX0 044366 LOWCR 
-DX1 044426 LOWCR 
. LBO 052002 LOWCR 
-LDR 052220 LOWCR 
- LDRHD 052040 LOWCR 
- LPO 044562 LOWCR 
- MMO 044704 LOWCR 
-MM1 044746 LOWCR 
-NLO 051570 LOWCR 
- PPO 045112 LOWCER 
- PRO 045234 LOWCR 
-SY0 052026 LOWCR 
- TIO 051706 LOWCR 


Symbol Value 


-TTO 
«TT] 
-TT10 
-TT11 
-TT12 
-TT13 
-TT15 
-TT16 
TTL] 
~TT2 
-TT20 
-TT21 
~TT22 
»TT23 
-TT24 
-TT25 
-TT26 
-TT27 
«TT3 
- TT30 
»TT31 
-TT4 
TTS 
-TT6 
~TT7 


045362 
045452 
046400 
046470 
046560 
046650 
046740 
047030 
047120 
047210 
045660 
047300 
047370 
050316 
050406 
050476 
050566 
050656 
050746 
045750 
051036 
051126 
046040 
046130 
046220 
046310 


CROSS-REFERENCES 


Modules That Reference Symbol 


He ste <= =H HE He HE OSE Ot OE OR OE HE EC HEE FE OE SE FE SE SE 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


9.4 MCRMU SEGMENT CROSS~REFERENCE 


The MCRMU segment cross-reference 


lists 


segment and the modules that compose it. 


Segment 
Name 


ERROV 
LUNOV 
MCROOT 
MCROV 
PRLOV 


EDCKP 
EXEDF 
EXEDF 
EDCKP 
ABOOV 
LKLST 


Resident Modules 


ERRMSG 
FMTDV 
LOWCR 
EXEDF 
EXEDF 
LN1OV 


ERROV 
LUNOV 
MCROOT 
GTMNM 
FIXOV 
PRLOV 


the name of each overlay 
The cross-reference follows: 


LKLST MCRDIS 
GNBLK GTMNM GTTSK 


CROSS-REFERENCES 


SYS Global Cross-references 


9.5 SYS GLOBAL CROSS-REFERENCES 
This cross-reference is for a mapped system. 


The cross-reference contains an alphabetic listing of each global 
symbol along with its value and the name of each referencing module. 
When a symbol is defined in several segments within an overlay 
structure, TKB prints the last defined value in the listing. 
Similarly, in a real TKB cross-reference listing, TKB would print the 
module name more than once for each symbol if the module is loaded in 
several segments within the structure. 


The Task Builder creates an SYS.CRF cross-reference file when /CR is 
specified in the Task Builder command file used to build SYS. One of 
the input files to the Task Builder when building SYS is the Executive 
symbol table file, RSX11M.STB. RSX11M.STB is needed because SYS 
references some Executive symbols. All the symbols from RSX11M.STB 
are put in the SYS.CRF symbol table file even though they are not 
ceferenced by SYS. Therefore, some symbols appearing here in the SYS 
cross-reference are defined in the Executive but not used by SYS. 
These symbols are shown defined in the Executive LOWCR or EXEDF 
modules. 


The value contains the suffix -R if the symbol is relocatable. 


Prefix symbols accompanying each module name define the type of 
reference as follows: 


Prefix 

Symbol Reference Type 

blank Module contains a reference that is resolved in the 
same segment or in a segment toward the root. 

. Module contains a reference that is resolved 
directly in a segment away from the root or ina 
co-tree. 

@ Module contains a reference that is resolved 
through an autoload vector. 

# Module contains a reference that is resolved 
This module defines the symbol. 

* Module contains an autoloadable definition. This 
module defines the symbol. 

Symbol Value Modules That Reference Symbol 

DV.F1l1 040000 # EXEDF SDSOV SPROV 

DV.ISP 002000 # EXEDF REDOV 

DV .MNT 100000 ALLOV DEAOV DEVOV # EXEDF REDOV 

SDSOV SPROV 

DV .OSP 004000 # EXEDF REDOV 

DV.PSE 010000 ALLOV ASNOV DEAOV DEVOV # EXEDF 
# LOWCR OPEOV REDOV SDSOV SPROV 

DV .SQD 000040 DEVOV # EXEDE 

DV .TTY 000004 ALLOV ASNOV ATLOV DEVOV # EXEDF 
# LOWCR SDSOV SPROV 


Symbol Value 


nV.UMD 
DSSYNM 
D.DSP 
D.LNK 
D.MSK 
D.NAM 


D.PCB 

0.RSO00 
D.RS1 

D.RS10 
O.RS16 
D.RS17 
D.RS19 
D.RS2 

D.RS22 
D.RSS 

D.RS6 

D.RS7 

D.RS8 

D.RS80 
D.RS81 
D.RS84 
D.RS85 
D.RS86 
D.RS87 
D.RS90 
D.RS92 
D.RS93 
D.RS94 
D.RS95 
D.RS96 
D.RS97 
D.RS98 
D.RS99 
D.UCB 


D.UCBL 
D.UNIT 


D.VCAN 
D.VINI 
D.VOUT 
D.VPWF 
EC .DTO 
EC.DVC 
EC.NST 
E.LGTH 
E.OPC 

E.RTRY 
E.SIZE 
FE.DRV 
FE .EXP 
FE.EXT 
FE.EXV 
FE.MUP 


FE.NLG 
FE.PKT 
FE.PLA 


000200 
000000 
000012 
000000 
000014 
000004 


000034 
000000 
177777 
177766 
177760 


177757 


177755 
177776 
000002 
177773 
177772 
177771 
177770 
177660 
177657 
177654 
177653 
177652 
177651 
177646 
177644 
177643 
177642 
177641 
177640 
177637 
177636 
177635 
000002 


000010 
000006 


000002 
000000 
000004 
000006 
000140 
000001 
000141 
000056 
000022 
000016 
000000 
000010 
000200 
000001 
000004 
000002 


100000 
000100 
000020 


CROSS~REFERENCES 


Modules That Reference Symbol 


# EXEDF 
# LOWCR 

DEVOV 

DEAOV 
# EXEDF 
ASNOV 
GTTSK 
SPROV 
DEVOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
DEAOV 
LOWCR 
DEAOV 
LOWCR 
DEAOV 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
BXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
DEVOV 
EXEDF 
EXEDF 
EXEDF 
ALLOV 
RUNOV 
EXEDF 
EXEDF 
EXEDF 


He He + He SHE He HE Ot te HR HR FE OE SE OE = ed te SE ste te SE SE SE Oe SE SE OR SE OE SR Oe Se OR OE eR St OE 


SHE se He 


t+ FF ste te 


ste He He HR =H HE EO eS 


LOWCR 


EXEDF 
DEVOV 
LOWCR 
DEAOV 
LOWCR 
SFDUCB 
EXEDF 


DEVOV 
OPEOV 
DEVOV 
SDSOV 
DEVOV 
$FDUCB 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
EXEDF 
SDSOV 
PAROV 
SPROV 
DEAOV 
SPROV 
SPROV 
SDSOV 
SETOV 


# LOWCR 
# EXEDF 


DEVOV 
OPEOV 


# LOWCR 


# EXEDF 
SDSOV 
# EXEDF 


SFDUCB 


# EXEDF 


SPROV 
SDSOV 


DEVOV 


SPROV 
SPROV 


SDSOV 


# EXEDF 
RAPOV 


OPEOV 


FMTDV 


SFDUCB 


FMTDOV 


FMTOV 


SETOV 


# EXEDF 


$SFDUCB 


FMTDV 
REDOV 


GTMNM 
GTMNM 


GTMNM 


TASOV 


RPSOV 


Symbol Value 


H.CSP 
H.GARD 
H.WND 
IE.ABO 
IE.ALN 
IE.BAD 
IE.BLK 
IE.BYT 
IE.DAA 
IE.DNA 
IE.DNR 
IE.IFC 
IE.LCK 
IE.NLN 
IE.NOD 
TE.OFL 
IE.OVR 
IE.PRI 
IE.SDP 
IE.SPC 
IE.ULK 
IE.UPN 
IO.ATT 


IO.CLN 
IO.DET 


IO.KIL 
I0.LOV 
IO0.RLB 
IO.RVB 


IO.ULK- 


IO.WAL 
IO.WLB 
IO.WVB 


IQ.UMD 
IS.SUC 
KISAR5 
KISAR6 
L.ASG 
L.LGTH 
L.LNK 
L.NAM 
L.TYPE 
L.UCB 
L.UNIT 
MS SMGE 
PADVBF 
PR7 

Ps 
P.ATT 
P.BLKS 
P.BUSY 
P.HDR 
P.IOC 
P.LGTH 
P.LNK 
P.MAIN 
P.NAM 
P .OWN 


000000 
000072 
000044 
177761 
177736 
177777 
177754 
177755 
177770 
177771 
177775 
177776 
177745 
177733 
177751 
177677 
177756 
177760 
177635 
177772 
177653 
177777 
001400 


003400 
002000 


000012 
001010 
001000 
010400 
005000 
000410 
000400 
011000 


000004 
000001 
172352 
172354 
000010 
000012 
000000 
000002 
000005 
000006 
000004 
000000 


125730-R 


000340 
177776 
000036 
000016 
000024 
000032 
000003 
000042 
000000 
000012 
000004 
000026 


Modules That Reference Symbol 


+e te SH He ste He SR te ie ER SE FE SE Se OE 


# 


(CROSS-REFERENCES 


ATLOV 
ATLOV 
EXEDF 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ALTOV 
LOWCR 
LOWCR 
ASNOV 
ASNOV 
OPEOV 
LOWCR 
ASNOV 
OPEOV 
ERROV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
SPROV 
LOWCR 
ASNOV 
LOWCR 
TASOV 
LOWCR 
LOWCR 
EXEDF 
EXEDF 
ASNOV 
ASNOV 
ASNOV 
ASNOV 
ASNOV 
ASNOV 
ASNOV 
LOWCR 
DEVOV 
EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
ATLOV 
EXEDF 
LOWCR 
EXEDEF 
ALTOV 
EXEDF 
EXEDF 


# EXEDF 
# EXEDF 


SYSROT 


ATLOV 
PAROV 


ATLOV 
PAROV 


RAPOV 
OPEOV 


OPEOV 
ATLOV 
OPEOV 
TIMOV 


LOWCR 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 


a se He oe Oe EH HE 


PAROV 
SETOV 
SETOV 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
SETOV 
LOWCR 
EXEDF 
LOWCR 
LOWCR 


SHE ste HR OE Se SE 


CLOQOV 
TASOV 


CLQOV 
TASOV 


TASOV 


REAOV 
CLOQOV 
PAROV 


# LOWCR 


SFDUCB 
# LOWCR 
# LOWCR 
# LOWCR 
# LOWCR 


OPEOV 


# LOWCR 


DEVOV 


DEVOV 


DEVOV 
SDSOV 


$FDUCB 


SFDUCB 
SFDUCB 
SFDUCB 
$FDUCB 


# LOWCR 


# LOWCR 


ERROV 
SPROV 


Symbol 


P.PRI 
P.PRO 
P.REL 
P.SIZE 
P.STAT 
P.SUB 
P.SWS2 
P.TCB 
P.WAIT 


SP.EIP. 


SP .ENB 
S.BMSK 
S.BMSV 
S.CCB 
S.CON 
S.CSR 
S.CTM 
S.DZCK 
S.FRK 
S.ITM 
S.LHD 
S.MPR 
S.PKT 
S.PRI 
S.RCNT 
S.ROFF 
§.STS 
S.vCcT 
T.EXT 
T.LGTH 
T.NAM 
T.PCB 
T.ST2 
T.ST3 
T.TCBL 
T.UCB 


T2.CKD 
T3.MCR 
UC.ATT 
UC.KIL 
UC.LGH 
UC.NPR 
UC.PWF 
UC.QUE 
UISARO 
UISDRO 
US.BSY 
US.FOR 
US.MDM 
US .MNT 


US.OFL 
US.PUB 


US.RED 
US .UMD 
US.WCK 
U.ACP 
U.ATT 


U.BUF 


Value 


000002 
000034 
000014 
000016 
000030 
000010 
000022 
000026 
000020 
000001 
000002 
177776 
177774 
000030 
000010 
000012 
000006 
000030 
000016 
000007 
000000 
000030 
000014 
000004 
177772 
177773 
000011 
000005 
000000 
000070 
000006 
000046 
000034 
000036 
000030 
000026 


010000 
004000 
000010 
000004 
000003 
000100 
000020 
000040 
177640 
177600 
000200 
000040 
000020 
000100 


000001 
000004 


000002 
000010 
000010 
000032 
000022 


000024 


Modules That Reference Symbol 


He EOE OE Se OSE SE HE SE HE HE SE aie 3 OSE He SE Ste He SHE He $e SHE te HE SHE HE HEE SR OE OE OE SR Oe SE i se 46 <te $e ste oi He IE 


=H AE =H He te te 


CROSS-REFERENCES 


EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
ALTOV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
LOWCR 
CLQOV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
S$FDUCB 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
DEVOV 
ALLOV 
REDOV 
DEVOV 
ALLOV 
SDSOV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
ALLOV 


EXEDF 


EXEDF 


ae He EE OE HE He Se te Se +e 4 aH He He OE te Se Se EF 


# 


=H He =H te HE HE Se SE te OE SE HE 


+6 4F 0 te aH 


LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
EXEDF 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


EXEDF 
LKLST 
LKLST 
RPSOV 
SETOV 
GTMNM 


LKLST 
RPSOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
EXEDF 
DEAOV 


EXEDF 
DEAOV 
SPROV 
REDOV 
LOWCR 
SDSOV 
LOWCR 
ASNOV 
LOWCR 
LOWCR 


# LOWCR 


SETOV 


PAROV 
SETOV 


SYSOV 


GTTSK 


SYSOV 


# LOWCR 
DEVOV 


# LOWCR 
DEVOV 


SPROV 


ATLOV 
REDOV 


SPROV 


# EXEDF 


SETOV 
# EXEDF 


CLQOV 


SYSOV 


# LOWCR 


# LOWCR 


DEVOV 


Symbol Value 


U.CNT 
U.CTL 
U.CW1l 


U.CW2 


U.CW3 
U.CW4 
U.DCB 


U:LUIC 
U.OWN 


U.RED 


U.SCB 
U.STS 


U.ST2 


U.UIC 

U.UNIT 
U.VCB 

U2.CRT 
U2.DH1 
U2.Dd1 
U2.D21 
U2.ESC 
U2.HLD 
U2.LOG 
U2.LWC 
U2.L3S 
U2.L8S 
U2.PRV 


U2.RMT 
U2.SLV 
U2.VT5 
VSSCTR 
W.BLVR 
X.AST 
X.DSI 
X.FORK 
X.ISR 
X.JSR 
X.LEN 
X.LNK 
X.PSW 
X.REL 
X.TCB 
X.VEC 
X.VPC 
SABCTK 
SABTIM 
SABTSK 
SACHCK 
SACHKB 
SACHKP 
SACHKW 
SACTEP 


000030 
000004 
000010 


000012 


000014 
000016 
000000 


177774 
177776 


000002 


000020 
000005 


000007 


000052 
000006 
000034 
002000 
100000 
040000 
000100 
001000 
000040 
000400 
000001 
000004 
010000 
000010 


020000 
000200 
000002 
000410 
000002 
000032 
000024 
000012 
000010 
000002 
000050 
000000 
000006 
000022 
000026 
000044 
000046 
014460 
005414 
014464 
007242 
007250 
007206 
007232 


122566-R 


Modules That Reference Symbol 


te SE te al 


He te E Ae se He SE OH +e 4 


# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


EXEDF 
EXEDF 
ALLOV 
EXEDF 
SPROV 


ALLOV 


EXEDF 
SPROV 
EXEDF 
EXEDF 
EXEDF 
SDSOV 
DEVOV 


ALLOV 


SDSOV 
ASNOV 
REDOV 
EXEDF 


ALLOV 


REDOV 


ALLOV 


REDOV 
EXEDF 
EXEDF 
DEVOV 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 


ALLOV 


EXEDF 
EXEDF 
EXEDF 


ASNOV 
SDSOV 


EXEDF 
EXEDF 
EXEDF 


LOWCR 
EXEDF 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


CLQOV 


LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 
ATLOV 


# 
$ 


+ 


# 


LOWCR 
LOWCR 
ASNOV 
LOWCR 


ASNOV 
LOWCR 
SYSOV 
LOWCR 
SDSOV 
FMTDV 
$SFDUCB 
EXEDF 
DEAOV 
SPROV 
DEVOV 
SPROV 
LOWCR 
DEAOV 
SDSOV 
DEAOV 
SDSOV 
SDSOV 
LOWCR 
EXEDF 
SDSOV 
SPROV 
SPROV 
SDSOV 
SDSOV 
SDSOV 
DEVOV 
SDSOV 
SDSOV 
SDSOV 
ATLOV 
SPROV 
SDSOV 
SDSOV 
SDSOV 


SYSROT 


LOWCR 


CROSS-REFERENCES 


ATLOV 
OPEOV 


ATLOV 
RUNOV 


SDSOV 
SPROV 
GTMNM 


RUNOV 
DEVOV 


EXEDF 


SETOV 
DEVOV 
SPROV 
DEVOV 
SETOV 
SPROV 
SETOV 
LOWCR 
SPROV 


SETOV 
SPROV 
SPROV 
EXEDF 
SPROV 
SPROV 
SPROV 
DEAOV 
SYSOV 
SPROV 
SPROV 
SPROV 


DEAOV 
REDOV 


DEAOV 
SDSOV 


SETOV 
GTTSK 


SPROV 
# EXEDF 


GTMNM 


# EXEDF 


# EXEDF 
SPROV 


SPROV 


# EXEDF 


DEVOV 
SDSOV 


DEVOV 
SETOV 


REDOV 


# LOWCR 


# LOWCR 


# LOWCR 


# LOWCR 


RUNOV 


Symbol Value 


SACTHD 
SACTRM 
SACTTK 
SALCLK 
SALEB1 
SALEMB 
SALLEP 
SALOCB 
SALOC1 
SALPKT 
SALTEP 
SASNEP 
SATLEP 
SBILDS 
SBLKCK 
SBLKC1 
SBLXIO 
SBMSET 
SBRKEP 
SBTMSK 
SCAT5 


$CBDMG 
$CBOMG 


SCDTB 

SCEFI 

SCEFN 

SCFLPT 
SCHKPT 
SCKACC 
SCKCNT 
SCKCSR 
SCKINT 
$CKLDC 
SCLINS 
$CLKHD 
SCLRMV 
SCOMEF 
SCOPT 

SCOTB 

SCRASH 
SCRATT 
SCRAVL 
SCRPAS 
SCRSBF 
SCRSBN 
S$CRSCS 
SCRSHT 
SCRSST 
SCRSUN 
SCVRTM 
SC5STA 


SDASTT 
$DBO 
SDDIV 
$DEACB 


SDEAC1 
SDEAEP 
$SDECLK 


005634 
015172 
014652 
006636 
032634 
032620 


123350-R 


006524 
006566 
006652 


122170-R 
122636-R 
122556-R 


014540 
010174 
010204 
006212 
032730 


124642-R 


005640 
127134 


124206 
125304 


127310 
007362 
007356 
005522 
016226 
033726 
005604 
005606 
017726 
005610 
014162 
005556 
014264 
005570 
005560 
127316 
001470 
034024 
005532 
012470 
000730 
001462 
001466 
001752 
001460 
001756 
007070 
005772 


015030 
043366 
124454 
006672 


006732 


123624-R 


006644 


Modules That Reference Symbol 


# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


SH =He =H te HE SE OE te Se SE +e = 4 SH ste $e Se ste HE te SE HE SE 


# 
# 


CROSS-REFERENCES 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ALLOV 
ASNOV 
LOWCR 
LOWCR 
ALTOV 
ASNOV 
ATLOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
BRKOV 
LOWCR 
ALTOV 
SPROV 
ATLOV 
ASNOV 
TASOV 
GETNUM 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
CLQOV 
LOWCR 
LOWCR 
LOWCR 
ASNOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ATLOV 
SDSOV 
LOWCR 
LOWCR 
CLQOV 
ASNOV 
SPROV 
LOWCR 
DEAOV 
LOWCR 


REAOV 
LOWCR 


RAPOV 


OPEOV 


GTTSK 
SYSOV 
CLQOV 
ATLOV 


RPSOV 


RUNOV 
LOWCR 


GETNUM 


SDSOV 


CLQOV 
TASOV 


LOWCR 


REAOV 


RPSOV 


OPEOV 


SDSOV 
FMTDV 


TIMOV 


OPEOV 


ERROV 


RPSOV 


SETOV 
RAPOV RPSOV 
TASOV 
GTMNM SDSOV 
$FDUCB 

# LOWCR PAROV 
RUNOV SETOV 


Symbol Value 


SDEPKT 
SDETRG 
SDEVEP 
SDEVHD 


$DEVTB 
SDIRSV 
SDIRXT 
SDIV 

$DKO 

SDPLM1 
SDPLM2 
SDOQLM1 
$DQLM2 
$DRABO 
SDRASG 
SDRATP 
SDRATR 
SDRATX 
SDRCEF 
SDRCMT 
SDRCRR 
$DRCRW 
$DRCSR 
SDRDAR 
$DRDCP 
SDRDSE 
SDRDTR 
SDREAR 
SDRECP 
SDREIF 
SDRELW 
$DREXP 
SDREXT 
$DRFEX 
SDRGCL 
SDRGLI 
SDRGMX 
SDRGPP 
SDRGSS 
SDRGTK 
S$DRGTP 
SDRLM1 
$DRLM2 
SDRMAP 
SDRMKT 
SDRPUT 
SDRQIO 
$DRORQ 
SDRRAF 
SDRRCV 
SDRREC 
SDRREQ 
SDRRES 
SDRRRA 
SDRRRF 
$DRRUN 
SDRSDV 
SDRSEF 
SDRSND 
$DRSPN 
SDRSRF 


006666 
031502 


122302-R 


005462 


043122 
002264 
002514 
012564 
043630 
021662 
021666 
026526 
026536 
022140 
022164 
032020 
031166 
022410 
032340 
022556 
030600 
024064 
022562 
022576 
022632 
032350 
031350 
022612 
022656 
004220 
024312 
022702 
004226 
026100 
023372 
023500 
025504 
023602 
023704 
023714 
024030 
021566 
021606 
024346 
025730 
026122 
026410 
027516 
032364 
026162 
030306 
031714 
031746 
026142 
025232 
025762 
032532 
032420 
030440 
032006 
024716 


CROSS-REFERENCES 


Modules That Reference Symbol 


+ 
# 
# 


SHE He He Se SOE RO HEE EE SFO SE HE Se 4 


SHE ste ste HE HE OH OE OE OE OHO HEHE EOE RHE SE SE ES ES SHE FE HE: + 4 


LOWCR 
LOWCR 
DEVOV 
DEAOV 
SFDUCB 
LOWCR 
LOWCR 
LOWCR 
FMTDV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
EDCKP 
LKLST 
LOWCR 
LOWCR 
EDCKP 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


DEVOV # LOWCR OPEOV SDSOV 
GTMNM # LOWCR TIMOV 

# LOWCR 

# LOWCR 

# LOWCR 


Symbol Value 


SDRSTV 
SDRUNM 
SDRWFL 
SDRWFS 
SDRWSE 
SDSW 

$pso 

SDTOER 
$DTO 

SDVCER 
SDVERR 
SDVMSG 
$DX0 

SDYPMN 
SEMSST 
SEMTRP 
SERREP 
SERRHD 
SERRLM 
SERRLN 
SERRPT 
SERRSQ 
SERRSV 
SERRSZ 
SERRTB 
SEXROF 
SEXRON 
SEXRQP 
SEXSIZ 
$FDLGG 
$FDLOG 


SFDUCB 
SFINBF 
SFLTRP 
SFMASK 


SEMTDV 


SFNDSP 
SFORK 

$FORKO 
SFORK1 
SFPINT 
SPRKHD 
SGNBLK 


SGTBYT 
SGTMNM 
SGTNUM 
SGTPKT 
SGTTSK 
SGTWRD 
SHEADR 


SICHKP 
SILINS 
SINITL 
SINTCT 
SINTSE 


032540 
024672 
032450 
032512 
032434 
000046 
044064 
032754 
044276 
033016 
033016 
007446 
044472 
005470 
017156 
021512 
122160-R 
005700 
005704 
000404 
005514 
005706 
005710 
005712 
124364-R 
016434 
016452 
016426 
005520 
126422-R 
126430-R 


126436-R 
003776 
017212 
005552 


125176-R 


015750 
002320 
002342 
002340 
017226 
005546 
126750-R 


006102 
126034-R 
126716-R 
007510 
125460-R 
006160 
005564 


016160 
017304 
052414 
005542 
002376 


Modules That Reference Symbol 


4h 0 SF stic HE OEE OE HE EOE SE OEE SHE ES EEE HE SE SE HE HE 


te aH: $e te SF Ste He 4 te A 


te 3 SE AF AE 


CROSS-REFERENCES 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ALTOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ERROV 
LOWCR 
LOWCR 
ERRMSG 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ERRMSG 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
$FDUCB 
ALLOV 
$FDUCB 
ASNOV 
LOWCR 
LOWCR 
ALLOV 
PAROV 
SPROV 
ASNOV 
TASOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ALLOV 
GNBLK 
LOWCR 
GTMNM 
ALTOV 
LOWCR 
ALTOV 
LOWCR 
GTTSK 
RPSOV 
$FDUCB 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


ASNOV 


TIMOV 


' BRROV 


ERROV 
RPSOV 
SDSOV 
ASNOV 
ATLOV 
DEAOV 
RPSOV 


TASOV 
ATLOV 


ASNOV 
GTTSK 
GETNUM 
GTTSK 


LKLST 
RUNOV 


SETOV 
DEAOV 
REDOV 
DEVOV 
RUNOV 


DEVOV 


ATLOV 


RAPOV 
RAPOV 


LOWCR 
SETOV 


SPROV 
RAPOV 


SFDUCB 


LOWCR 
SDSOV 


FMTDV 


DEAOV 


RPSOV 


OPEOV 
SYSROT 


SPROV 


OPEOV 
SETOV 


SDSOV 


DEVOV 


SPROV 


RAPOV 
TASOV 


Symbol Value 


SINTSV 
SINTXT 
SINTX1 
SIOABM 
SIOALT 
$SIODON 
SIOFIN 
SIOKIL 
SIOTRP 
SLCKPR 
SLDPWF 
SLDRPT 
SLOAD 

SLOADR 
SLOADT 
SLOCKL 


SLOGHD 
SLPO 
SLSTLK 
SMAPTK 
SMBUF 


SMCKD 
SMCKE 
SMCMD 


$MCOV 
SMCR 


SMCRCB 
SMCRPT 
S$MDIS 
SMDPB 


SMERLD 


SMERR 
SMERRN 


S$MLDOV 
SMLIMI 
SMLINE 
$MMO 

SMOVRB 
SMPARS 


SMPCSR 
SMPLND 


002434 
002374 
002456 
005714 
010272 
010274 
010414 
010666 
017316 
011552 
014124 
005464 
121004 
041214 
016422 
124564-R 


005624 
044614 
005630 
017036 
120362-R 


122512-R 
122524-R 
120454-R 


120464-R 
120634-R 


005626 
005466 
120500-R 
120366-R 


120720-R 


120470-R 
120474-R 


120724-R 
120632-R 
120504-R 
045014 

120416-R 
120424-R 


012734 
011126 


Modules That Reference Symbol 


# 
# 
# 
# 
# 
# 
# 
# 
i 
# 
# 
+ 
# 
# 


CROSS-REFERENCES 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
SYSRO?T 
LOWCR 
LOWCR 
ASNOV 
REDOV 
ASNOV 
LOWCR 
LKLST 
LOWCR 
ASNOV 
OPEOV 
SYSOV 
EDCKP 
EDCKP 
ERROV 
SYSROT 
SPROV 
ALLOV 
CLQOV 


' PAROV 


% 4 4b 


Se 4 


# 
# 


SDSOV 
TIMOV 
LOWCR 
LOWCR 
SYSRO?T 
ASNOV 
PAROV 
SYSROT 
ALLOV 
DEAOV 
REAOV 
SETOV 
TIMOV 
SYSROT 
ALLOV 
DEAOV 
RAPOV 
SDSOV 
TASOV 
RAPOV 
ATLOV 
SYSOV 
LOWCR 
SYSROT 
ALLOV 
DEVOV 
REAOV 
SETOV 
LOWCR 
LOWCR 


ATLOV 
SETOV 
LOWCR 


LOWCR 


ATLOV 
PAROV 
SYSROT 
ERROV 
ERROV 
RAPOV 


SYSOV 
ALTOV 
DEAOV 
REAOV 
SETOV 


RPSOV 


ATLOV 
RAPOV 
TASOV 
ALTOV 
DEVOV 
REDOV 
SPROV 


ALTOV 
DEVOV 
REAOV 
SETOV 
TIMOV 
RPSOV 
DEVOV 
SYSROT 


ALTOV 
ERROV 
REDOV 
SPROV 


DEVOV 
TASOV 
$FDUCB 


CLQOV 
RPSOV 
TASOV 


RPSOV 


# SYSROT 
ASNOV 
DEVOV 
REDOV 
SPROV 


ASNOV 
OPEOV 
RPSOV 
# SYSROT 


# LKLST 


DEVOV 
SDSOV 
TIMOV 


SPROV 


ATLOV 
ERROV 
RPSOV 


# SYSROT 


ERROV 
SDSOV 


ATLOV 
PAROV 
RUNOV 


# SYSROT 


ATLOV — 


OPEOV 
RPSOV 
SYSOV 


SYSOV 
# SYSROT 


ATLOV 
PAROV 
RUNOV 
TASOV 


PAROV 


ERROV 
SPROV 


SYSOV 


BRKOV 
OPEOV 
RUNOV 
TASOV 


OPEOV 
SPROV 


CLQOV 
RAPOV 
SDSOV 
TASOV 


CLQOV 
PAROV 
RUNOV 
SYSROT 


SYSROT 
TASOV 


DEAOV 
RAPOV 
SDSOV 
TIMOV 


Symbol Value 


SMPLNE 
SMPLUN 
SMPPHY 
SMPPKT 
SMPRSR 
SMPVBN 
SMROOT 
SMTERM 
$MUCB 


$MUL 
SMXEXT 
SNLO 
SNNBLK 
SNONSI 
$NSO 
SNS1 
SNS2 
5NS3 
SNS4 
SNS5 
SNS6 
$NS7 
SNULL 
SNXTSK 
SOPEEP 
SPANIC 
$PAREP 
$PARHD 


SPARPT 
SPARTB 
$PCBS 
SPKAVL 
$PKMAX 
$PKNUM 
SPOOL 
SPOWER 
SPPO 
SPRO 
SPTBYT 
SPTWRD 
SPWRFL 
SQASTT 
SQEMB 
SQINSF 
SQINSP 
SQMCRL 
SQRMVF 
SQRMVT 
SRAPEP 
SREAEP 
SREDEP 
$RELOC 
SRELOM 
$RELOP 
$RLMCB 
SRLPAR 
SRLPR1 
SRPSEP 
SROQSCH 


011106 
011070 
011170 
011240 
120460-R 
011372 
120706-R 
120476-R 
120364-R 


012534 
005770 
051622 
126752-R 
002556 
033300 
033306 
033314 
033322 
033330 
033336 
033344 
033352 
043100 
015322 
122226-R 
001470 
123654-R 
005422 


005554 
012670 
052164 
005764 
005767 
005766 
052310 
013750 
045144 
045266 
006132 
006160 
005416 
015062 
033516 
014332 
014340 
014376 
014406 
014420 
122144-R 
123142-R 
123000-R 
012222 
012272 
012410 
023434 
015246 
015310 
122206-R 
005452 


CROSS-REFERENCES 


Modules That Reference Symbol 


# 
# 
# 
# 
# 
# 


$6 3 ie SE Se te SF AE =He te 4 = S42 He He OH EO HE SESE SE -SECE E + te 4 SH te SE He HE HR OE OE EE SE 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
SYSOV 
LOWCR 
SYSROT 
RPSOV 
ALLOV 
DEVOV 
SPROV 
LOWCR 
LOWCR 
LOWCR 
GNBLK 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ALTOV 
OPEOV 
LOWCR 
DEVOV 
LOWCR 
SPROV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ALTOV 
LOWCR 
LOWCR 
ALTOV 
RAPOV 
REAOV 
ALTOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
RPSOV 
LOWCR 


# SYSROT 


RUNOV 
ASNOV 
PAROV 
SYSOV 
RUNOV 
SDSOV 


SPROV 


# LOWCR 


# PAROV 
OPEOV 


SDSOV 


SDSOV 


# LOWCR 


# LOWCR 


# REDOV 


9-51 


SYSOV 
ATLOV 
RPSOV 
SYSROT 
SPROV 


TIMOV 


PAROV 


SPROV 


# SYSROT 
CLQOV DEAOV 
RUNOV SDSOV 
TIMOV 
SDSOV SETOV 


Symbol Value 


SRUNEP 
SSAVNR 
SSCDVT 
SSCDV1 
SSDSEP 
SSETCR 
SSETEP 
SSETF 
SSETM 
SSETRQ 
SSETRT 
SSGFLT 
SSHFPT 
SSIGFL 
SSOVEP 
SSPREP 
SSRATT 
SSRNAM 
SSRSTD 
SSRWND 
SSTACK 
SSTD 
SSTKDP 
SSTPCT 
SSTPTK 
SSWSTK 
SSYBEG 
SSYSID 
SSYSIZ 
SSYTOP 
SSYUIC 
STALEP 
STASEP 
STIMEP 
STKNPT 
STKPS 
STKTCB 


STKWSE 
STRACE 
STRPO4 
STRTRP 
STSKHD 
STSKRP 
STSKRQ 
STSKRT 
STSTCP 
STTNS 
STTO 
STT1l 
STT10 
STT11 
$TT12 
$TT13 
STT14 
STT15 
STT16 
$TT17 
STT2 
STT20 
$TT21 
$TT22 


122144-R 
004144 
012306 
012312 
122676-R 
014704 
122164-R 
014762 
014766 
014734 
014732 
017336 
005516 
005420 
122134-R 
122700-R 
034124 
033644 
015132 
034162 
000642 
052220 
005454 
015222 
015226 
004164 
053424 
005574 
005716 
063424 
005612 
122576-R 
122172-R 
122260-R 
005600 
005744 
005446 


032430 
017376 
017410 
021446 
005512 
016504 
016502 
016476 
016052 
005762 
045534 
045564 
047672 
047722 
047752 
050002 
050032 
050062 
050112 
050142 
047452 
050172 
050222 
051210 


CROSS-REFERENCES 


Modules That Reference Symbol 


# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


Se SHE HE HEE SEE EEE SEE SE SE Se SF a FE te 


RUNOV 
CBTO 

LOWCR 
LOWCR 
SDSOV 
LOWCR 
SETOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LKLST 
SYSOV 
SPROV 
LOWCR 
LOWCR 
GTTSK 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ATLOV 
TASOV 
TIMOV 
LOWCR 
CLQOV 
EDCKP 
RPSOV 
LKLST 
BRKOV 
LOWCR 
LOWCR 
ALTOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
CLQOV 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


CBTO # LOWCR 


# LOWCR 

* SYSROT 

# LOWCR OPEOV RPSOV RUNOV 
RUNOV 
OPEOV SETOV SPROV 
SDSOV SPROV 

# LOWCR RUNOV TIMOV 
GTMNM GTTSK LKLST # LOWCR 
SPROV SYSOV SFDUCB 

# LOWCR 

# LOWCR 

# LOWCR SETOV TASOV 
RUNOV 

# LOWCR RUNOV TIMOV 


Symbol Value 


$STT23 
STT24 
$TT25 
STT26 
$TT27 
$TT3 
$TT30 
$TT31 
STT4 
STT5 
STT6 
STT7 
SUISET 
SUNLKL 


SUNMAP 
SUSRTB 
$XDT 
-CBTO 
.CLO 
-COT2B 
-co0 
~C22T0 
DBO 
-DB1l 
.~DB2 
~DB3 

- DKO 
-DK1 
~DK2 
DSW 
-DSO 
-DS1 
-DS2 
e~DTO 
.DT1 
-DX0 
~DX1l 
»KEYWD 
J LBO 
~LDR 

.» LDRHD 
e LPO 
MMO 
-MM1 
-NLO 
PPO 
PRO 
-SY0 
TIO 
-TTO 
-TT1 
-TT10 
-TT11 
-TT12 
.TT13 
-TT14 
-TT15 
-TT16 
.TT17 
~TT2 


051260 
051310 
051340 
051370 
051420 
047502 
051450 
051500 
047532 
047562 
047612 
047642 
016776 


124654-R 


034222 
000000 
035002 


124752-R 


051756 


125056-R 


051732 


124732-R 
124666-R 


043162 
043222 
043262 
043322 
043464 
043524 
043564 
000044 
043720 
043760 
044020 
044162 
044226 
044366 
044426 


127020-R 


052002 
052220 
052040 
044562 
044704 
044746 
051570 
045112 
045234 
052026 
051706 
045362 
045452 
046400 
046470 
046560 
046650 
046740 
047030 
047120 
047210 
045660 


CROSS-REFERENCES 


Modules That Reference Symbol 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
ALTOV 
PAROV 
LOWCR 
LOWCR 
LOWCR 
CBTO 

LOWCR 
COT2B 
LOWCR 
CBTO 

CBTO 

LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
KEYWD 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


He He HE HE te HE HE HE OE ote ote Ae EE 
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ASNOV 
REDOV 


DEVOV 


OPEOV 


OPEOV 
OPEOV 


OPEOV 


9-53 


ATLOV 
SETOV 


OPEOV 


PAROV 
PAROV 


RPSOV 


DEVOV # LKLST 
SYSOV TASOV 
PAROV 
SPROV 


(CROSS~REFERENCES 


Symbol Value Modules That Reference Symbol 


-TT20 047300 # LOWCR 
-TT21 047370 # LOWCR 
-TT22 050316 # LOWCR 
-TT23 050406 # LOWCR 
-TT24 050476 # LOWCR 
-TT25 050566 # LOWCR 
-TT26 050656 # LOWCR 
-TT27 050746 # LOWCR 
-TT3 045750 # LOWCR 
-TT30 051036 # LOWCR 
-TT31 051126 # LOWCR 
-TT4 046040 # LOWCR 
-TT5 046130 # LOWCR 
-TT6 046220 # LOWCR 
~TT7 046310 # LOWCR 


9.6 SYS SEGMENT CROSS-REFERENCES 


The SYS segment cross-reference lists the name of each overlay and the 
modules that compose it. The cross-reference follows: 


Segment 

Name Resident Modules 

ALTOV ALTOV EXEDF GETNUM GTMNM GTTSK LKLST 
REDOV $FDUCB 

ATLOV ATLOV EXEDF FMTDV GNBLK GTMNM GTTSK 
LKLST SFDUCB 

CLQOV CLQOV EXEDF 

DEVOV CBTO DEVOV EXEDF FMTDV GNBLK LKLST 
PAROV 

ERROV EDCKP ERRMSG ERROV 

OPEOV BRKOV CBTO COT2B KEYWD OPEOV 

RAPOV ASNOV EXEDF FMTDV GETNUM GNBLK GTMNM 
GTTSK LKLST RAPOV $FDUCB 

REAOV ALLOV DEAOV EXEDF GNBLK REAOV $FDUCB 

RPSOV EXEDF GETNUM KEYWD RPSOV 

RUNOV EXEDF RUNOV 

SDSOV EXEDF FMTDV SDSOV 

SETOV EXEDF LKLST SETOV 

SPROV EXEDF GETNUM GNBLK KEYWD SPROV SFDUCB 

SYSOV EXEDF LKLST SYSOV 

SYSROT EXEDF LOWCR SYSROT 

TASOV EXEDF FMTDV LKLST TASOV 

TIMOV GNBLK TIMOV 


9.7 BIGFCP GLOBAL CROSS REFERENCES 


The cross-reference contains an alphabetic listing of each global 
symbol along with its value and the name of each referencing module. 
When a symbol is defined in several segments within an overlay 
structure, TKB prints the last defined value in the listing. 
Similarly, in a real TKB cross-reference listing, TKB would print’ the 
module name more than once for each symbol if the module is loaded in 
several segments within the structure. 


CROSS~REFERENCES 


The value contains the suffix -R if the symbol is relocatable. 


The Task Builder creates a BIGFCP.CRF cross-reference file when /CR is 
specified in the Task Builder command file used to build BIGFCP. One 
of the input files to the Task Builder when building BIGFCP is the 
Executive symbol table file, RSX11M.STB. RSX11M.STB is needed because 
BIGFCP references some Executive symbols. All the symbols’ from 
RSX11M.STB are put in the BIGFCP.CRF symbol table file even though 
they are not referenced by BIGFCP. Therefore, some symbols appearing 
here in the BIGFCP cross-reference are defined in the Executive but 
not used by BIGFCP. These symbols are shown defined in the Executive 
LOWCR or EXEDF modules. 
Prefix symbols accompanying each module name 
reference as follows: 


define the type of 


Prefix 

Symbol Reference Type 

blank Module contains a reference that is resolved in the 
same segment or in a segment toward the root. 

. Module contains a reference that is resolved 
directly in a segment away from the root or ina 
co-tree, 

@ Module contains a reference that is resolved 
through an autoload vector. 

# Module contains a non-autoloadable definition. 
This module defines the symbol. 

* Module contains an autoloadable definition. This 
module defines the symbol. 

Symbol Value Modules That Reference Symbol 
AT.FCB 000100 # ATCTL RATCM WATCM 
AT.HDR 000000 # ATCTL 

AT.IDN 000001 # ATCTL 

AT.MAP 000002 # ATCTL 

AT.PRO 000040 # ATCTL WATCM 

AT.RO 000200 # ATCTL WATCM 

DV.PSE 010000 # EXEDF # LOWCR 

DV .TTY 000004 # EXEDF # LOWCR 

DV .UMD 000200 # EXEDF # LOWCR 

DSSYNM 000000 # LOWCR 

D.DSP 000012 # EXEDF # LOWCR 

D.MSK 000014 # EXEDF # LOWCR 

D.NAM 000004 # EXEDF # LOWCR 

D.PCB 000034 # EXEDF # LOWCR 

D.RSOO0 000000 # LOWCR 

D.RS1 1977777 # LOWCR 


Symbol Value 


D.RS10 
D.RS16 
D.RS17 
D.RS19 
D.RS2 

D.RS22 
D.RSS5 

D.RS6 

D.RS7 

D.RS8 

D.RS80 
D.RS81 
D.RS84 
D.RS85 
D.RS86 
D.RS87 
D.RS90 
D.RS92 
D.RS93 
D.RS94 
D.RS95 
D.RS96 
D.RS97 
D.RS98 
D.RS99 
D.UCB 

D.UCBL 
D.UNIT 
D.VCAN 
D.VINI 
D.VOUT 
D.VPWF 
EC .DTO 
EC.DVC 
EC.NSI 
E.BDHD 
E.LGTH 
E.OPC 

E.RTRY 
E.SIZE 
FE.MUP 
F.EFBK 
F.FFBY 
F.HIBK 
F.RSIZ 
F.RTYP 
IE.ABO 
IE.ALC 
IE.ALN 
IE.BAD 


IE.BDR 
IE.BHD 
IE.BLK 
IE.BVR 
IE.BYT 
IE.CKS 
IE.CLO 
IE.DAA 
IE.DFU 
IE.DNA 


177766 


177760 


177757 
177755 
177776 
000002 
177773 
177772 
177771 
177770 
177660 
177657 
177654 
177653 
177652 
177651 
177646 
177644 
177643 
177642 
177641 
177640 
177637 
177636 
177635 
000002 
000010 
000006 
000002 
000000 
000004 
000006 
000140 
000001 
000141 
000000 
000056 
000022 
000016 
000000 
000002 
000010 
000014 
000004 
000002 
000000 
177761 
177654 
177736 
177777 


177716 
177700 
177754 
177701 
LIT7S5 
177742 
177732 
177770 
177750 


~ 1777721 


Modules That Reference Symbol 


4 HE Oe HE He HE EOE HE HEE EHR HR HE SE SE SR OE OO OE EOE te OSE SE EE IE 


CROSS-REFERENCES 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR . 


LOWCR 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
DISPAT 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
CRFIL 
DRACC 
DRACC 
DRACC 
DRACC 
DRACC 
LOWCR 
SMALC 
LOWCR 
ACCESS 
DRINI 
LOCAT 
DRACC 
NXHDR 
LOWCR 
ENTNM 
LOWCR 
RDHDR 
ACCESS 
LOWCR 
SMALC 
LOWCR 


Se 4b He te AE ste 4 4 SE SE Se OE OSE HE FE 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
RDHDR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
EXEDF 
DREOF 
DREOF 
DREOF 


RWVBL 


CRFIL 
ENTNM 
LOWCR 


RDHDR 


PROCK 


DEACC 
EXCOM 
RWATT 


SMDEL 


DISPAT 
GTFID 
RWVB 


SMSCN 


DLMRK 
INWIN 


Symbol Value 


IE.DNR 
ITE.DUP 
IE.EOF 
IE.HFU 
IE.IFC 
IE.IFU 
IE.LCK 
IE.NLN 
IE.NOD 
IE.NSF 
IE.OFL 
IE.OVR 
IE.PRI 
IE.RER 
IE.SNC 
IE.SPC 
IE.SQC 
IE.ULK 
IE.UPN 
ITE.WAC 
IE.WAT 
IE.WER 
IE.WLK 
IO.ACR 
IO.ATT 
IO.CLN 
IO.CRE 
IO.DEL 
IO.DET 
IO.EXT 
IO.FNA 
IO0.LOV 
IO.RLB 
IO.RVB 
IO.ULK 
IO.WLB 
IO.WVB 
IQ.UMD 
IS.SUuC 
KISARS 
KISAR6 
L.ASG 

L.NAM 

L.TYPE 
L.UCB 

L.UNIT 
MSSMGE 
NB.SNM 
NB.STP 
NB.SVR 
N.DID 

N.FNAM 
N.FVER 
N.NEXT 
N.STAT 
P.ATT 

P.BLKS 
P.BUSY 
P.HDR 

P.IOC 

P.LGTH 
P.LNK 


177775 
177707 
177766 
177744 
177776 
177747 
177745 
177733 
177751 
177746 
177677 
177756 
177760 
177740 
177735 
177772 
177734 
177653 
177777 
177743 
177741 
177737 
177764 
006400 


-001400 


003400 
012000 
012400 
002000 
011400 
004400 
001010 
001000 
010400 
005000 
000400 
011000 
000004 
000001 
172352 
172354 
000010 
000002 
000005 
000006 
000004 
000000 
000040 
000020 


000010 


000024 
000006 
000016 
000022 
000020 
000036 
000016 
000024 
000032 
000003 
000042 
000000 


Modules That Reference Symbol 


# 


tHe 6 =H SE 
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CROSS-REFERENCES 


LOWCR 
ENTNM 
RWVB 
EXCMP 
LOWCR 
CRFID 
ACCESS 
GTFID 
ALLOC 
DLMRK 
LOWCR 
LOWCR 
LOWCR 
RWILB 
RDHDR 
LOWCR 
NXHDR 
LOWCR 
RWVBL 
ACCESS 
RATCM 
CLNUP 
CRFIL 
ACCESS 
LOWCR 
LOWCR 
CLCOM 
CLCRE 
LOWCR 
DREXT 
DRACC 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
ENTNM 
ENTNM 
ENTNM 
DRINI 
FNDNM 
ENTNM 
ENTNM 
ENTNM 
LOWCR 
EXEDF 
EXEDF 
CRFIL 
EXEDF 
LOWCR 
EXEDF 


# 
# 
# 
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RWVBL 


LOWCR 
LOWCR 
LOWCR 
FDRMV 


PROCK 


RDHDR 
RW1LB 
WATCM 


RW1LB 
PROCK 


TRUNC 


TRONC 
RWVBL 
PROCK 


TRUNC 


RW1LB 


RW1LB 


LOCAT 
LOCAT 
LOCAT 


PROCK 


WACCK 


RDHDR 


WRATT 


Symbol Value 


P.MAIN 
P.NAM 
P.OWN 
P.PRI 
P.PRO 
P.REL 
P.SIZE 
P.STAT 
P.SUB 
P.SWSZ 
P.TCB 
P.WAIT 
R.FIX 


SP.EIP | 


SP.ENB 
S.BMSK 
S.BMSV 
S.CCB 
S.CON 
S.CSR 
S.CTM 
S.DRFN 
S.DZCK 
S.FRK 
S.ITM 
S.LHAD 
S.MPR 
S.NFEN 
S.PKT 
S.PRI 
S.RCNT 
S.ROFF 
S.STS 
S.vCT 
T.EXT 
T.LGTH 
UC.ATT 
UC.KIL 
UC.LGH 
UC.NPR 
UC. PWF 
UC.QUE 
UISARO 
UISDRO 
US.BSY 
US.FOR 
US .MDM 
US.MNT 
US .OFL 
US.PUB 
US .UMD 
U.ACP 
U.ATT 
U.BUF 
U.CNT 
U.CTL 
U.CWl 
U.CW2 
U.CW3 
U.OWN 
JU .RED 
U.SCB 


000012 
000004 
000026 
000002 
000034 
000014 
000016 
000030 
000010 
000022 
000026 
000020 
000001 
000001 
000002 
177776 
177774 
000030 
000010 
000012 
000006 
000032 
000030 
000016 
000007 
000000 
000030 
000020 
000014 
000004 
177772 
177773 
000011 
000005 
000000 
000070 
000010 
000004 
000003 
000100 
000020 
000040 
177640 
177600 
000200 
000040 
000020 
000100 
000001 
000004 
000010 
000032 
000022 
000024 
000030 
000004 
000010 
000012 
000014 
177776 
000002 
000020 


Modules That Reference Symbol 


ote He HE de OE OE OE Se te Se OE EE HE SE SH oe SE HE HE Se He He te EH HE te SE He He SE te ee OE EE FE 


SHE te $e Oe HE SHE EOE HE SE RE HEE SE 


CROSS-REFERENCES 


EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
DRACC 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
DREX 
LOWCR 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
DRACC 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
LOWCR 
LOWCR 
EXEDF 
EXEDF' 
EXEDF 
EXEDF 
EXEDE' 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
DISPAT 
DMOUNT 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 
EXEDF 


He te te ste te He te Se Se SE A He sHe HE 


ste 3b te 


Se SH Ae te te Se 


SHe SHE SHE He He te OHH SE OE SE SHE SE OE He He 4 te He AE SE HE HE SE 


LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 
DRINI 


LOWCR 
LOWCR 
LOWCR 


ENTNM 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


# LOCAT 


FDRMV 


DMOUNT # EXEDF 


EXEDF 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


# LOWCR 


RMVNM 


# LOWCR 


Symbol Value 


U.STS 

U.ST2 

U.UNIT 
U.VCB 

VSSCTR 
X.AST 

X.DSI 

X.FORK 
X.ISR 

X.JSR 

X.LEN 

X.LNK 

X.PSW 

X.REL 

X.TCB 

X.VEC 

X.VPC 

SABCTK 
SABTIM 
SABTSK 
SACHCK 
SACHKB 
SACHKP 
SACHKW 
SACTHD 
SACTRM 
SACTTK 
SALCLK 
SALEBL 
SALEMB 
SALERR 
SALOCB 
SALOC1 
SALPKT 
$BILDS 
SBLKCK 
SBLKCl 
SBLXIO 
SBMSET 
SBTMSK 
SCEFI 

SCEFN 

SCFLPT 
SCHKPT 
SCKACC 
SCKCNT 
SCKCSR 
SCKINT 
$CKLDC 
SCLINS 
SCLKHD 
SCLRMV 
SCOMEF 
SCOPT 

SCRASH 
SCRATT 
SCRAVL 
SCRPAS 
SCRSBF 
SCRSBN 
SCRSCS 
SCRSHT 


000005 
000007 
000006 
000034 
000410 
000032 
000024 
000012 
000010 
000002 
000050 
000000 
000006 
000022 
000026 
000044 
000046 
014460 
005414 
014464 
007242 
007250 
007206 
007232 
005634 
015172 
014652 
006636 
032634 
032620 


122774-R 


006524 
006566 
006652 
014540 
010174 
010204 
006212 
032730 
005640 
007362 
007356 
005522 
016226 
033726 
005604 
005606 
017726 
005610 
014162 
005556 
014264 
005570 
005560 
001470 
034024 
005532 
012470 
000730 
001462 
001466 
001752 


CROSS-REFERENCES 


Modules That Reference Symbol 


# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
+ 
it 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 
# 


DISPAT 


EXEDF 
EXEDF 
CLNUP 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
OVERR 
ALLOC 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
BLXIO 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


DMOUNT 


# LOWCR 


# LOWCR 
DISPAT 


# LOWCR 


# LOWCR 


# EXEDF # LOWCR 


DMOUNT # EXEDF # LOWCR 


Symbol 


SCRSST 
SCRSUN 
SCVRTM 
SC5TA 
SDASTT 
SDBO 
SDDIV 
$DEACB 
SDEACL 
$SDECLK 
SDEPKT 
$DETRG 
SDEVHD 
SDEVTB 
SDIRSV 
SDIRXT 
SDIV 


$DKO 
SDMUL 
SDPLM1 
$DPLM2 
SDOQLM1 
$DQLM2 
SDRABO 
SDRASG 
SDRATP 
SDRATR 
SDRATX 
SDRCEF 
SDRCMT 
SDRCRR 
SDRCRW 
SDRCSR 
SDRDAR 
SDRDCP 
SDRDSE 
SDRDTR 
SDREAR 
SDRECP 
SDREIFP 
SDRELW 
SDREXP 
SDREXT 
SDRFEX 
SDRGCL 
SDRGLI 
SDRGMX 
$DRGPP 
SDRGSS 
$DRGTK 
SDRGTP 
SDRLM1 
$DRLM2 
$DRMAP 
SDRMKT 
SDRPUT 
SDROQIO 
SDRQRQ 
SDRRAF 
SDRRCV 
SDRREC 


Value 


001460 
001756 
007070 
005772 
015030 
043366 


121164-R 


006672 
006732 
006644 
006666 
031502 
005462 
043122 
002264 
002514 
012564 


043630 


121126-R 


021662 
021666 
026526 
026536 
022140 
022164 
032020 
031166 
022410 
032340 
022556 
030600 
024064 
022562 
022576 
022632 
032350 
031350 
022612 
022656 
004220 
024312 
022702 
004226 
026100 
023372 
023500 
025504 
023602 
023704 
023714 
024030 
021566 
021606 
024346 
025730 
026122 
026410 
027516 
032364 
026162 
030306 


Modules That Reference Symbol 


# 


SH He HE OE HEE ESE HE HE SE HE 


He He He HE HR He OE HOHE OH OHE $e OR HE te FOE He =He He SHE SHE OOH OE He EO SEO HE SE St EOS HE OEE 


CROSS-REFERENCES 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
DARITH 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
DATIM 
SMDEL 
LOWCR 
DARITH 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


SMALC 
RLEAS 


DLHDR 


SMALC 


DMOUNT # LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


RWVB 


SMDEL 


INWIN 


IXEXT 


# LOWCR 


Symbol Value 


SDRREQ 
SDRRES 
SDRRRA 
SDRRRF 
$DRRUN 
SDRSDV 
SDRSEF 
SDRSND 
SDRSPN 
SDRSRF 
SDRSTV 
SDRUNM 
SDRWFL 
SDRWFS 
SDRWSE 
SDSW 
$Ds0 
SDTOER 
SDTO 
SDVCER 
SDVERR 
SDVMSG 
$DX0 
SDYPMN 
SEMSST 
SEMTRP 
SERRHD 
SERRLM 
SERRPT 
SERRSQ 
SERRSV 
SERRSZ 
SEXROF 
SEXRON 
SEXROP 
SEXSIZ 
SFINBF 
SFLTRP 
SFMASK 
SFNDSP 
SFORK 
$FORKO 
S$FORKL 
SFPINT 
$FRKHD 
SGTBYT 
SGTPKT 
SGTWRD 
SHEADR 
SICHKP 
SILINS 
SINITL 
SINTCT 
SINTSE 
SINTSV 
SINTXT 
SINTX1 
$IOABM 
SIOALT 
$IODON 
SIOFIN 
SIOKIL 


031714 
031746 
026142 
025232 
025762 
032532 


032420 


030440 
032006 
024716 
032540 
024672 
032450 
032512 
032434 
000046 
044064 
032754 
044276 
033016 
033016 
007446 
044472 
005470 
017156 
021512 
005700 
005704 
005514 
005706 
005710 
005712 
016434 
016452 
016426 
005520 
003776 
017212 
005552 
015750 
002320 
002342 
002340 
017226 
005546 
006102 
007510 
006160 
005564 
016160 
017304 
052414 
005542 
002376 
002434 
002374 
002456 
005714 
010272 
010274 
010414 
010666 


Modules That Reference Symbol 


= SH HE OSE OSE SE SHE SE SE tHe EE SHe He OE OR OE OE OE HE SH SH He Se HE te EOE ESE SE SHE HE HE HE SHE =e 3 He He He SHEP te SHE te HE EE HE HE HE 


CROSS-REFERENCES 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
OVERR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


DMOUNT # LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
CRFIL 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
DISPAT 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
DISPAT 
LOWCR 


RWVBL 


# LOWCR 


# LOWCR 


# LOWCR 


RWILB 


PROCK 


MPVBN 


Symbol Value 


SIOTRP 
SLCKPR 
SLDPWF 
SLDRPT 
SLOADR 
SLOADT 
$LOGHD 
SLPO 
SLSTLK 
SMAPTK 
SMCRCB 
SMCRPT 
SMMO 
SMPCSR 
SMPLND 
SMPLNE 
SMPLUN 
SMPPHY 
SMPPKT 
SMPVBN 
SMUL 
SMXEXT 
SNLO 
SNONSI 
SNSO 
SNS1 
SNS2 
SNS3 
SNS4 
SNS5 
SNS6 
SNS7 
SNULL 
SNXTSK 
SPANIC 
SPARHD 
SPARPT 
SPARTB 
SPCBS 
SPKAVL 
SPKMAX 
$PKNUM 
SPOOL 
SPOWER 
SPPO 
SPRO 
SPTBYT 
SPTWRD 
$PWRFL 
SQASTT 
SQEMB 
SQINSF 
SQINSP 
SQMCRL 
SQRMVF 
SQRMVT 
$RELOC 
SRELOM 
$RELOP 
SRLMCB 
SRLPAR 
SRLPR1 


017316 
011552 
014124 
005464 
041214 
016422 
005624 
044614 
005630 
017036 
005626 
005466 
045014 
012734 
011126 
011106 
011070 
011170 
011240 
011372 
012534 
005770 
051622 
002556 
033300 
033306 
033314 
033322 


033330 


033336 
033344 
033352 
043100 
015322 
001470 
005422 
005554 
012670 
052164 
005764 
005767 
005766 
052310 
013750 
045144 
045266 
006132 
006160 
005416 
015062 
033516 
014332 
014340 
014376 
014406 
014420 
012222 
012272 
012410 
023434 
015246 
015310 


Modules That Reference Symbol 


SHE SH: ste =H SE Bo SH =H He “He He EOE ORE OE EOE AE HEE EOS SESE FE SPS FP SHE SE -s -A SE SE E HE FE fe oH tHe ste te HE te HE OSE OE SEO SE EO EH FE 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
DATIM 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR. 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


RWVB 
MPVBN 
# LOWCR 


DISPAT # LOWCR 


LOWCR 
BLXIO 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


# LOWCR 


CROSS-REFERENCES 


RWVBL 
RATCM 


WATCM 


Symbol Value 


SRQSCH 
SSAVNR 
SSCDVT 
SSCDV1 
SSETCR 
SSETF 
SSETM 
SSETRQ 
SSETRT 
SSGFLT 
SSHFPT 
SSIGFL 
SSRATT 
S$SRNAM 
SSRSTD 
SSRWND 
SSTACK 
$STD 
SSTKDP 
SSTPCT 
SSTPTK 
SSWSTK 
SSYBEG 
SSYSID 
SSYSI2 
SSYTOP 
SSYUIC 
STKNPT 
STKPS 
STKTCB 
STKWSE 
STRACE 
STRPO4 
STRTRP 
STSKHD 
STSKRP 
STSKRQ 
STSKRT 
STSTCP 
STTNS 
$TTO 
STTl 
STT10 
STT11 
$TT12 
$TT13 
STT14 
STTL5 
STT16 
$TT17 
STT2 
STT20 
STT21 
STT22 
$TT23 
STT24 
$TT25 
STT26 
$TT27 
STT3 
$TT30 
$TT31 


005452 
004144 
012306 
012312 
014704 
014762 
014766 
014734 
014732 
017336 
005516 
005420 
034124 
033644 
015132 
034162 
000642 
052220 
005454 
015222 
015226 
004164 
053424 
005574 
005716 
063424 
005612 
005600 
005744 
005446 
032430 
017376 
017410 
021446 
005512 
016504 
016502 
016476 
016052 
005762 
045534 
045564 
047672 
047722 
047752 
050002 
050032 
050062 
050112 
050142 
047452 
050172 
050222 
051210 
051260 
051310 
051340 
051370 
051420 
047502 
051450 
051500 


Modules That Reference Symbol 


Ste ste sik HE te He Oe HE OE HE OR EOE HE OE SE SR SR SE SE SF SE te OS OE EOE Oe SE te SHe SHE te OE Oe RE He He HE ste sth He te se OR OE Se HE HE Oe OR te te te te 


CROSS-REFERENCES 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


WTRN1 


DISPAT # LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
DISPAT 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 


DMOUNT # LOWCR 


(CROSS-REFERENCES 


Symbol Value Modules That Reference Symbol 

$TT4 047532 # LOWCR 

$STT5 047562 # LOWCR 

$TT6 047612 # LOWCR 

$TT7 047642 # LOWCR 

SUISET 016776 # LOWCR 

SUNMAP 034222 # LOWCR 

SUSRTB 000000 # LOWCR 

$XDT 035002 # LOWCR 

~ACBMX 000006 # ATCTL RATCM WATCM 

-ACCES 136540-R * ACCESS @ DISPAT 

. AGAIN 121406-R # DISPAT DREXT IXEXT 

eALCAD 121640-R EXCMP EXCOM EXTEN # F11CM 

eALCTL 121632-R EXCMP EXCOM EXTEN # F11CM SMALC 

~-ALFCB 120252-R # ALLOC INFCB 

» ALLOC 120274-R ACCESS # ALLOC INWIN 

~ALOBT 126144-R SMALC # SMSCN 

~ATCTL 137414-R * ATCTL RATCM WATCM 

-ATMAX 000016 # ATCTL RATCM WATCM 

»BLXI 120340-R # BLXIO DRINI EXTEN GTFID WATCM 

~BLXI1l 120344-R # BLXIO 

»BLXO 120372-R # BLXIO CLCRE CRFIL — DREX EXCMP 
EXCOM RATCM 

-BLXO1 120376-R # BLXIO 

»CKFRE 126136-R SMALC # SMSCN 

-CKSM1 120430-R # CKSUM 

-CKSUM 120424-R # CKSUM DREXT RDHDR WRHDR 

~CLACC 120450-R # CLACC CLNUP 

~CLAC1 120516-R # CLACC CLDAC 

» CLCRE 136722-R * CLCRE CLNUP 

-» CLDAC 121034-R # CLDAC CLNUP DEACC 

. CLDEL 136520-R * CLCOM CLNUP 

~CLDIR 137030-R * CLDIR CLNUP DREOF DREXT DRWRT 
FNDNM 


* 


-CLEXTI 137730-R CLNUP @ DISPAT 

-CLEXT 137134-R CLCRE * CLEXT CLNUP @ DISPAT 
-CLEX1 121302-R DISPAT TRUNC 

» CLEX2 121304-R DISPAT EXTHD 

-CLFCB 137526-R CLFCB @ DISPAT 

-CLFC1 121316-R CLCOM CLDAC CLEXT # DISPAT 


% te tHe 


-CLNUP 137744-R * CLNUP @ FLICM 

-CLRAT 136660-R * CLCOM CLNUP 

-CLWAT 136702-R * CLCOM CLNUP 

-CLO 051756 # LOWCR 

-CO0 051732 # LOWCR 

»CRFCB 122062-R ACCESS DRACC EXTHD # INFCB RDATT 
-CRFID 137466-R * CRFID CRFIL EXTHD 


* 


-CRFIL 137670-R CRFIL @ DISPAT 


-DATIM 140346-R CRFIL * DATIM DEACC 
- DBO 043162 # LOWCR 

-DB1 043222 # LOWCR 

-DB2 043262 # LOWCR 

-DB3 043322 # LOWCR 

- DEACC 140502-R * DEACC @ DISPAT 


«DELBT 126154-R SMDEL # SMSCN 


- DKO 043464 # LOWCR 

-DK1 043524 # LOWCR 

-DK2 043564 # LOWCR 

- DLBLK 140110-R CLEXT * DLBLK DLFIL DREXT 
-DLBL1 140130-R CLEXT * DLBLK 

-DLFIL 140304-R CLCRE @ DISPAT * DLFIL 

-DLFL1 121314-R CLDAC # DISPAT DLMRK 


-DLHDR 140356-R CLCOM CLEXT DLFIL * DLHDR 


Symbol Value 


.- DLHD1 
- DLMRK 
- DMOUN 
-DRACC 
- DRALC 
- DRBUF 
»DRCPY 
-DREF1 
- DRENB 
» DREOF 
» DREX 

-DREXT 
- DREX1 
- DRFNB 
- DRFRE 
- DRGET 
- DRHRC 
» DRHVR 
-DRINI 
- DRLBN 
-DRLVB 
- DRNLB 
» DRPAC 
- DRSEF 
-DRUCB 


- DRVLB 
- DRWEX 
- DRWRT 
-DRX1 
-DSPAT 
-DSW 

e DSO 
-DS1 
-DS2 
-DTO 
-DT1 

- DX0 
-DX1 
-ENTNM 
- ENTRY 
» ERMSG 
~EXCMP 
-EXCM1 
« EXCM2 
-EXCM3 
~EXCNT 
~EXCOM 
-EXDSP 


-EXFCB 
« EXFNU 
-EXHDJ 
»EXHDR 
~EXIT 

» EXNHD 
~EXSTS 


» EXTEN 
~EXTE] 


140404-R 
140516-R 
140716-R 
141160-R 
121324-R 
140652-R 
131232-R 
141704-R 
121322-R 
134232-R 
142020-R 
142100-R 
142132-R 
121320-R 
122252-R 
122246-R 
142624-R 
122242-R 
122244-R 
143050-R 
131226-R 
122250-R 
134232-R 
143172-R 
142040-R 
131224-R 


143250-R 
143416-R 
143354-R 
142104-R 
121452-R 
000044 
043720 
043760 - 
044020 
044162 
044226 
044366 
044426 
143446-R 
121330-R 
121604-R 
141550-R 
121276-R 
121310-R 
121312-R 
142624-R 
142114-R 
121616-R 


‘121630-R 


121626-R 
142030-R 
121622-R 
121510-R 
121624-R 
121617-R 


142770-R 
143064-R 


Modules That Reference Symbol 


ae @ @ AF 3Ae 4H @® Ae VW @® BE AE SE OSE HE OE HEE ES 


CROSS~REFERENCES 


CLCRE 
DISPAT 
DISPAT 
DISPAT 
DISPAT 
DRALC 
DRGET 
DRCPY 
DISPAT 
DRGET 
DISPAT 
DREX 
DISPAT 
DISPAT 
DRINI 
ENTNM 
DRGET 
LOCAT 
ENTNM 
DRINI 
DRWRT 
ENTNM 
DRGET 
DRPAC 
DREOF 
CLNUP 
SCFAC 
DRCPY 
DRWRT 
DRWRT 
DREX 
DISPAT 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
DISPAT 
DISPAT 
F11CM 
DISPAT 
DISPAT 
DISPAT 
DISPAT 
DISPAT 
DISPAT 
CLCRE 
F11CM 
EXCMP 
CLEXT 
DISPAT 
CLCOM 
CLNUP 
CLEXT 
ACCESS 
CRFIL 
RDATT 
DISPAT 
DISPAT 


* + 


% aH 


* 


CLEXT 
DLMRK 
DMOUNT 
DRACC 
ENTNM 
DREXT 
DRWRT 
DREXT 
DRWRT 
FL1CM 
DREOF 
FNDNM 
DREXT 
ENTNM 
ENTNM 
LOCAT 
ENTNM 


LOCAT. 
ENTNM 
F11CM 
FDRMV 
ENTNM 
ENTNM 
DREXT 
DMOUNT 


DRGET 
ENTNM 
ENTNM 
DRWRT 
DRACC 


ENTNM 


EXCMP 
DREXT 
EXCOM 
EXCMP 
EXCOM 
EXCOM 
CLNUP 
IXEXT 
EXCOM 
EXTHD 
EXCMP 
CLEXT 
DISPAT 
EXTHD 
CLCRE 
DEACC 
TRUNC 
EXTEN 
EXTEN 


9-65 


* DLHDR 


FNDNM 


# F11CM 


FDRMV 


@ LOCAT 


FNDNM 


LOCAT 
F11CM 
FNDNM 


te +e 


DRGET 
* DRVLB 
RMVNM 
RMVNM 


DREXT 


EXTEN 


DISPAT 


EXTHD 
# FL1CM 


EXCOM 


# FL1CM 
CLDAC 
EXCOM 
WRATT 


RMVNM 


LOCAT 


RMVNM 


RMVNM 
ENTNM 


ENTNM 


IXEXT 


DLFIL 


F11CM 


F11CM 


TRONC 
CLEAT 
EXTHD 


# F11CM 


DREXT 


TRUNC 


CLNUP 
# FL1CM 


Symbol 


-EXTHD 
~EXTH1 
~EXTN1 
»EXTSV 
- FCBAD 


- FDRMV 
»FILNO 


-FILSQ 


- FNDNM 
. FREPT 
» FRLH 

»FLEND 
-F10ORG 
eGTFID 


»GTMAP 


-HDBUF 


- HDLBN 
- HDUCB 


- INFCB 


-INIT 
- INWIN 
-IOPKT 


-IOSTS 


~ IXEXT 
-IXEX1 
- LBO 
-LDR 

-» LDRHD 
»LOCAT 
LPO 

- MMO 
»MM1 
-MPHDR 
-MPVBN 
-NDRLB 
»NDRSZ 
-NLO 
-NOOP 


Value 


143320-R 
121306-R 
121274-R 
121620-R 
121614-R 


144032-R 
121606-R 


121610-R 
144360-R 
125620-R 
121644-R 
136134-R 
134234-R 
121720-R 


122044-R 


130224-R 


130220-R 
130216-R 
122100-R 
143772-R 


144034-R 
121570-R 


121600-R 


144526-R 
121300-R 


052002 
052220 
052040 


122304-R 


044562 
044704 
044746 


122604-R 
122650-R 
142126-R 
142124-R 


051570 


121566-R 


Modules That Reference Symbol 
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+e 3—- 4 


CROSS-REFERENCES 


EXCMP 
DISPAT' 
CRFIL 
CLCOM 
ACCESS 
CLFCB 
DREOF 
ENTNM 
FNDNM 
RATCM 
WACCK 
FDRMV 
ACCESS 
DRINI 
IXEXT 
CRFIL 
RDHDR 
DISPAT 
EXCMP 
ALLOC 
F11CM 
F11CM 
ACCESS 
RWATT 
CLCOM 
EXCMP 
NXHDR 
ACCESS 
DEACC 
DREOF 
F11CM 
RATCM 
WTRNL 
CRFIL 
CLCOM 
DMOUNT 
WRHDR 
CLFCB 
INFCB 
DISPAT 
ACCESS 
CLNUP 
DREXT 
SMALC 
ACCESS 
EXCMP 
SMALC 
DISPAT 
CLNUP 
LOWCR 
LOWCR 
LOWCR 
ENTNM 
LOWCR 
LOWCR 
LOWCR 
CRFIL 
DRVLB 
DREXT 
DREXT 
LOWCR 
DISPAT 


* EXTHD 
EXCOM 


# DISPAT 


CLEXT 
CLACC 
DEACC 
DREXT 
EXCMP 
# FL1CM 
RDATT 
WATCM 
FNDNM 
CLACC 
EXCMP 
RDATT 
DRINI 
SCFCB 
* FNDNM 
EXCOM 
# F11CM 
INIT 
INIT 
DEACC 


CLEXT 
EXCOM 
RDHDR 
CLCOM 
DLBLK 
DREXT 
GTMAP 
RDHDR 


EXTHD 
CLNUP 
DREXT 


DRACC 
RDATT 
* INIT 
DRACC 


DISPAT 


DRVLB 
SMNXB 
CLEXT 
EXCOM 
WATCM 
* IXEXT 
CRFIL 


FDRMV 


EXTHD 
EXTEN 


EXCOM 
CLCOM 
DLMRK 
DRGET 
EXCOM 
GTFID 
RDHDR 


RMVNM 
CLCRE 
FNDNM 
RDHDR 
FNDNM 


SMCOM 
INIT 


RLEAS 
DLMRK 


CLFCB 
EXTHD 
TRUNC 
CLDAC 
DLHDR 
EXCMP 
INFCB 
TRUNC 


F11CM 
CRFID 
EXTHD 


DREXT 
WATCM 


INWIN 
DLBLK 
ENTNM 
TROUNC 
CLNUP 
EXTHD 


DISPAT 


LOCAT 


MPHDR 
MPHDR 


F11CM 
CLDAC 
DRACC 
DRPAC 
EXTHD 
INWIN 
SCFAC 


CRFIL 
F11CM 
SCFCB 
F11CM 


RLEAS 


EXTEN 


CRFIL 
GTMAP 


CLEXT 
DLMRK 
EXCOM 
NXHDR 
WATCM 


INFCB 
DLBLK 
F11CM 


EXCMP 


DRACC 
FDRMV 


DISPAT 
F11CM 


RDHDR 


# MPVBN 


TRUNC 
CLDIR 
DRCPY 
DRWRT 
FDRMV 
IXEXT 
TRUNC 


DLMRK 
GTFID 


IXEXT 


GTFID 


DLFIL 
INFCB 


CRFIL 
DRACC 
EXTHD 
PROCK 
WRHDR 


DLHDR 
RDHDR 


EXTHD 


DREX 
F11CM 


DREXT 
RWVBL 


Symbol Value 


»NXHDR 
~NXHD1 
«PPO 

»PRCK1 
»PRCK2 
»PRCK3 
- PROCK 


PRO 

-QIOST 
-RATCM 
»RDATT 
-RDFHD 


-RDHDR 
-» RDNLB 
-RDLLB 


- RHDFN 
- RHDLB 
- RLEAS 


-RLFCB 
- RMVNM 
»RWATT 
-RWSIZ 
» RWVB, 
-RWVBL 
-RWVB1 
-SCFAC 


-SCECB 
-» SMALC 
-SMBUF 
~SMCNT 
-SMCTL 
»-SMDEL 
~SMEXT 
-SMFLG 
- SMNXB 
-SMRVB 


-SMSCN 
- SMUCB 


-SMVBN 


~-SMLAD 
-SMIBT 


-SM1MK 
-SM1VB 
»SM2AD 
-SM2BT 
- SM2MK 
-SM2VB 
-SSTSZ 
eSSTVC 
» STACK 
-START 


122706=-R 
122724-R 
045112 

123024-R 
123034-R 
123044-R 
123014-R 


045234 

121574-R 
144370-R 
144614-R 
123256-R 


123316-R 
124222-R 
124242-R 


123334-R 
123342-R 
123512-R 


123554=R 
145002-R 
144772-R 
124220-R 
145046-R 
123646-R 
121326-R 
124376-R 


124466-R 
124530-R 
127216-R 
125614-R 
125611-R 
145050-R 
125610-R 
100000 

125622-R 
125730-R 


126102-R 
127212-R 


127214-R 


125572-R 
125564-R 


125570-R 
125574-R 
125600-R 
125604-R 
125602-R 
125576-R 
000007 

121646-R 
120252-R 
121334-R 


Modules That Reference Symbol 
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CROSS-REFERENCES 


ACCESS 
CLEXT 
LOWCR 
PROCK 
DLMRK 
ENTNM 
ACCESS 
WATCM 
LOWCR 
F11CM 
ACCESS 
DISPAT 
ACCESS 
DRACC 
RDHDR 
CLFCB 
DRGET 
CRFID 
RDHDR 
CLEXT 
RDHDR 
CLACC 
DMOUNT 
RLFCB 
CLACC 
DISPAT 
RDATT 
RW1LB 
DISPAT 
DISPAT 
DISPAT 
ACCESS 
RWATT 
DRPAC 
DRALC 
F11CM 
SMALC 
DRALC 
CLEXT 
EXCOM 
F11CM 
SMALC 
CLEXT 
SMDEL 
SMALC 
CLACC 
INWIN 
CLCOM 
SMSCN 
SMALC 
CLEXT 
SMALC 
SMALC 
SMALC 
SMCOM 
SMALC 
SMCOM 
SMALC 
F11CM 
FLICM 
CLNUP 
DISPAT 


# 


tH + He oH: He te 


EXCOM 
DLFIL 


PROCK 
FDRMV 
EXTEN 


RWVBL 
RATCM 
RDATT 
CLCRE 
DREOF 
RWATT 
RDHDR 
RWLLB 
CRFIL 
RW1LB 
EXTHD 


CLCOM 
EXTEN 
SCFAC 
CLFCB 
RMVNM 
RWATT 


RWVB 

RWVBL 
RWVB 

DLMRK 
SCFAC 
SCFAC 
EXCOM 
INWIN 
SMCOM 
EXCMP 
DLBLK 
SMCOM 
SMALC 
SMNXB 
DLFIL 
SMNXB 
SMDEL 
CLCOM 
SMALC 
CLNUP 


SMCOM 
DRALC 
SMCOM 
SMCOM 
SMCOM 
SMCOM 
SMCOM 


DISPAT 
RWVB 


9-67 


# NXHDR 
# NXHDR 


# PROCK 
# PROCK 


RW1LB 
RDATT 


CLFCB 
DREXT 


WITRN 
DLHDR 
SMRVB 
NXHDR 
CLDIR 
RATCM 
WATCM 
# RLFCB 


WRATT 


DRACC 


RDATT 


RWATT 


DEACC 
EXCMP 


DRCPY 
RDATT # 


CLNUP 
RDATT # 


DREXT 


SMDEL 
SMNXB 
SMALC # 


SMRVB 


EXCMP 


DMOUNT # 


- SMALC 


EXCOM 
TRUNC 


# F1L1CM 


TRUNC 


TRUNC 


DLMRK 
EXTEN 


EATEN 


SMNXB 


SMCOM 


SMALC 


F11CM 


SMNXB 


EXTHD 


Symbol Value 


»SVLBN 
-SY0 
- TIO 
« TRUNC 
-TTO 
-TT1 
-TT10 
-TT11 
-TT12 
-TT13 
-TT14 
-TT15 
-TT16 
-TT17 
-TT2 
-TT20 
»TT21 
-TT22 
-TT23 
-TT24 
-TT25 
.TT26 
~TT27 
Pd 
-TT30 
-TT31 
-TT4 
TTS 
-TT6 
~TT7 
- UCBAD 


-USEPT 
»WACCK 
»WATCM 
»WITRN 


- WNDOW 


eWRATT 
»WRHDR 


-WRHD1 
-WRILB 


»WTRN1 
» ZERCT 


125560-R 
052026 
051706 
145274-R 
045362 
045452 
046400 
046470 
046560 
046650 
046740 
047030 
047120 
047210 
045660 
047300 
047370 
050316 
050406 
050476 
050566 
050656 
050746 
045750 
051036 
051126 
046040 
046130 
046220 
046310 
121572-R 


125616-R 
145172-R 
145212-R 
126172-R 


121612-R 


145542-R 


126272-R 


126304-R 
124234-R 


126330-R 
000021 


Modules That Reference Symbol 
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CROSS-REFERENCES 


DLBLK 
LOWCR 
LOWCR 
DLMRK 
LOWCR 
LOWCR 


LOWCR 


LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
LOWCR 
CLACC 
DLBLK 
F1L1CM 
SMALC 
EXCMP 
DRACC 
CRFIL 
DRVLB 
RWVB 
ACCESS 
EXCMP 
INWIN 
DISPAT 
CLCOM 
DREOF 
WRHDR 
CRFID 
DLHDR 
WRHDR 
ACCESS 
DISPAT 


EXCMP 


* TRUNC 


CLNUP 
DMOUNT 
PROCK 
SMRVB 
EXCOM 
EXTEN 
DEACC 
EXTEN 
RWVBL 
CLACC 
EXTEN 
IXEXT 
* WRATT 
CLDAC 
DREXT 


DLHDR 
DRCPY 


EXCMP 
# F11CM 


EXCOM 


CRFID 
DREXT 
RDHDR 
WRHDR 
SMCOM 
WACCK 
WATCM 
INWIN 
WITRN 
CLDIR 
EXTHD 
TRUNC 


CLEXT 
EXCMP 


WRHDR 
DRWRT 


EXTHD 


# SMCOM 


CRFIL 
DRGET 
RWVB 


WRATT 
WRATT 
IXEXT 


DEACC 


# F11CM 


WRATT 


CRFIL 
EXTHD 


# RW1LB 


WITRN 


DISPAT 
ENTNM 
SCFAC 


MPHDR 
DRVLB 
GTFID 


DLMRK 
WRATT 


SMRVB 


# WIRN1 


CROSS-REFERENCES 


9.8 BIGFCP SEGMENT CROSS-REFERENCES 


The BIGFCP segment cross-reference lists the name of each overlay and 
the modules that compose it. The cross-reference follows: 


Segment 

Name Resident Modules 

FCPHI ACCESS ATCTL CRFID CRFIL DATIM DEACC 
DMOUNT DRACC EXCMP EXCOM EXTEN EXTHD 
INIT INWIN RATCM RDATT RWATT RWVB 
WACCK WATCM WRATT 

FCPLO CLCOM CLCRE CLDIR CLEXT CLFCB CLNUP 
DLBLK DLFIL DLHDR DLMRK DRALC DRCPY 
DREOF DREX DREXT DRGET DRINI DRPAC 
DRVLB DRWRT ENTNM FDRMV FNDNM IXEXT 
RMVNM SMDEL TRUNC 

F11ACP ALLOC BLXIO CKSUM CLACC CLDAC DARITH 
DISPAT EXEDF FLIACP F11CM GTFID GTMAP 
INFCB LOCAT LOWCR MPHDR MPVBN NXHDR 
OVERR PROCK RDHDR RLEAS RLFCB RWVBL 
RWLLB SCFAC SCFCB SMALC SMCOM SMNXB 
SMRVB SMSCN WITRN WRHDR WTRN1 


9.9 CONDITIONAL ASSEMBLY PARAMETER TO MODULE CROSS-REFERENCE 


This cross-reference contains a listing of the conditional assembly 
Parameters that are contained in the Executive modules. Listed to the 
right of each parameter are those Executive modules that contain 
conditional assemblies affected by the parameter. 


Conditional 

Assembly Modules That Contain 

Parameter The Parameter 

ASSCHK DRATX DRDSP DRGLI DRGPP DRGTK DRGTP 
DRQIO DRRAS DRSED DRSST IOSUB SSTSR 
TTDRV 

ASSCPS DKTAB DMTAB DRQIO DRRES DTTAB DXTAB 
IOSUB 

AS$DO1 BFCTL 

ASSF11 BFCTL 

ASSNSI DRQIO MMTAB MTDRV MTTAB 

ASS$PRI DRDSP DREIF DRRES 

ASSTRP DRATX DRCIN DRDAR DRDSP DREIF DREXP 
DRMAP DRPUT DRREG IOSUB LOADR POWER 
REQSB SYSXT TDSCH TTDRV 

BS$OOT CRASH 

CSSCDA CRASH 


Conditional 
Assembly 
Parameter 


CSS$CKP 


CSSINT 
CS$SMPT 
CS$$RSH 
DS$Bll 
DS$Bl1l-1 
DSSH11 


DSSIAG 


DSSISK 
D$$J1l1 
D$$L11 
DS$M11 
DS$P11 
D$$Pl1-1 
D$$Qll 
D$$Qll-1 
DSS$SHF 
DSSvUll 
DS$U11-1 
DS$wll 
D$$W1ll-1 
DS $WCK 
DS$YNC 
DSSYNM 


D$$Z11 


DS$ZMD 


CROSS-REFERENCES 


Modules That Contain 
The Parameter 


DRATX 
IOSUB 
TTDRV 
DRCIN 
XUDRV 
CRASH 
XBDRV 
XBDRV 
LOWCR 
CTTAB 
DPDRV 
IOSUB 
PPTAB 
DRATX 
IOSUB 
TTDRV 
TTDRV 
TTDRV 
XPDRV 
XPDRV 
XOQDRV 
XQDRV 
DRCIN 
XUDRV 
XUDRV 
XWDRV 
XWDRV 
DBDRV 
DREXP 
DRCIN 
DRREQ 
SYSXT 
TTDRV 


TTDRV 


DRDCP 
LOADR 


DRDCP 


TTDRV 
DBDRV 
DRQIO 
LPTAB 
SYSTB 


DRDCP 
LOADR 


IOSUB 


DMDRV 
LOADR 
DRDSP 


IOSUB 
TDSCH 


DRDSP 
REQSB 


REQSB 


DKTAB 
DTDRV 
MMDRV 


DRDSP 
REQSB 


PARTY 


DPDRV 
REQSB 
DREIF 


PLSUB 
TTDRV 


DREIF 
SYSCM 


SYSXT 


DLDRV 
DTTAB 
MMTAB 


DREIF 
TDSCH 


REQSB 


SYSCM 


DREXP 
REQSB 


DREXP 
SYSXT 


DRDSP 


DMDRV 
DXTAB 
MTDRV 


DRREG 


TDSCH 


DRGPP 
SYSCM 


DRREG 
TDSCH 


DREIF 


DMTAB 
ERROR 
MTTAB 


DRRES 


DRREG 
SYSDF 


CROSS-REFERENCES 


Conditional 

Assembly Modules That Contain 

Parameter The Parameter 

ESSDVC CTDRV CTTAB DBDRV DKTAB DLDRV DMDRV 
DMTAB DPDRV DRDRV. DTDRV DTTAB DXDRV 
DXTAB ERROR TOSUB LPTAB MMDRV MMTAB 
MTDRV MTTAB POWER . PPTAB SYSCM SYSTB 
SYSXT 

ESSEAE POWER SYSXT 

ESSNSI DRCIN ERROR LOWCR POWER SYSCM SYSXT 

ESSPER ERROR PARTY POWER 

ESSXPR DRDSP DREXP LOADR SYSCM 

FSSAST POWER SSTSR 

FSSLPP DRDSP DREIF DRPUT POWER REQSB SSTSR 
SYSXT 

FSSLTP SSTSR 

GSSTPP DRDSP DRGPP 

GS$STSs DRDSP DRGSS 

GSSTTK DRDSP DRGTK 

GSSWRD BFCTL 

I$S$cll LOWCR 

ISSCAD BFCTL 

ISSRAR DREIF TTDRV 

ISSRDN DREIF TTDRV 

KSSCNT SYSCM 

KSSCSR SYSCM 

KSSLDC SYSCM 

KS$SWll POWER TDSCH 

LSS$11R LPDRV 

L$$50H8 TTDRV 

LSSASG DRASG 

LSSDRV CTTAB DKTAB DMTAB DRGLI DRQTIO DTTAB 
DXTAB IOSUB LPTAB MMTAB MTTAB POWER 
PPTAB QUEUE REQSB SYSCM SYSTB SYSXT 
TDSCH TTDRV 

LSSLDR LOADR SYSCM SYTAB 

LS$$Pll LPDRV 


9-71 


Conditional 
Assembly 
Parameter 
LS$S$SIl 
LDS$$H 
LD$$J 
LDS$L 
LDS$Z 
LDSCT 
LDSDK 
LDSDM 
LDSDT 
LD$DX 
LDSLP 
LDSMM 
LDSMT 
LDSNL 
LDSPP 
LDSPR 
LD$TT 
LDSTT 
MSS$CRI 
MSSCRX 


MSSEXT 


MSSIXD 


MSSMGE 


CROSS-REFERENCES 


Modules That Contain 
The Parameter 


CRASH 


TTDRV 


TTDRV . 


TTDRV 
TTDRV 
CTTAB 
DKTAB 
DMTAB 
DTTAB 
DXTAB 
LPTAB 
MMTAB 
MTTAB 
SYSTB 
PPTAB 
PPTAB 
SYSTB 
XMDRV 
TTDRV 
DRDSP 
DBDRV 
DRDRV 
MTDRV 
XMDRV 
DBDRV 
BFCTL 
DMDRV 
DRDSP 
DRGTP 
DRSST 
IOSUB 
MMTAB 
PPTAB 


SYSTB 
XMDRV 


INITL 


TTIDORV 


DREIF 


DKTAB 
DTDRV 
MTTAB 
XQDRV 


IOSUB 


CRASH 
DMTAB 
DREIF 
DROIO 
DTDRV 
LOADR 
MTDRV 
QUEUE 
SYSXT 
XPDRV 


POWER 


DRGCL 


DLDRV 
DTTAB 
POWER 


MMDRV 


CTTAB 
DPDRV 
DREXP 
DRRAS 
DTTAB 
LOWCR 
MTTAB 
REQSB 
SYTAB 
XQDRV 


SYSCM 


DMDRV 
INITL 
SYSCM 


DBDRV 
DRATX 
DRGLI 
DRREG 
DXDRV 
LPDRV 
PARTY 
SSTSR 
TDSCH 
XUDRV 


SYSXT 


DMTAB 
IOSUB 
SYSDF 


DKTAB 
DRCIN 
DRGPP 
DRREQ 
DXTAB 
LPTAB 
PLSUB 
SYSCM 
TTDRV 
XWDRV 


TTDRV 


DPDRV 
MMDRV 
XBDRV 


DLDRV 
DRDRV 
DRGTK 
DRSED 
INITL 
MMDRV 
POWER 
SYSDF 
XBDRV 


Conditional 
Assembly 
Parameter 


MSSMUP 


MSSNET 


NS$SMOV 
NSSUMR 
P$$D70 
PS$S$GMX 
PSSLAS 


P$$P45 
P$$R11 
PSSRFL 
PSSRTY 
PSSSRF 


P$$WRD 
Q$$22 

Q$$Io 

QS$SOPT 
QSSCRC 
QSSMPT 
R$$11s 
RS$60F 
RS$611 
RSSDER 
R$ SEXV 
RS$JP1 
RSSJPO 
RSSJS1 


CROSS-REFERENCES 


Modules That Contain 
The Parameter 


CTTAB 
DRMKT 
DXTAB 
SYSCM 


DRQIO 
XUDRV 


BFCTL 
SYSCM 
PARTY 
DRDSP 
DRDSP 
DRREG 
SYSCM 
NULTK 
PRDRV 
DRDSP 


INITL 


- DRDSP 


SYTAB 
BFCTL 
XMDRV 
XMDRV 
CORAL 
XQDRV 
XQDRV 
DRGTK 
DMDRV 
DMDRV 
CORAL 
SYSCM 
DBDRV 
DBDRV 


IOSUB 


DKTAB 
DRQIO 
LPTAB 
SYSTB 


LOWCR 
XWDRV 


DRMAP 
DREIF 


LOADR 
SYSXT 


DREIF 
PARTY 


DREIF 


IOSUB 


INITL 
IOSUB 


IOSUB 


SYSXT 
IOSUB 


IOSUB 


DMTAB 
DRRAS 
MMTAB 
TTDRV 


XBDRV 


DREXP 
LOWCR 
SYTAB 


DRPUT 
POWER 


DRMAP 


SYSCM 


LOADR 


DRASG 
DRREQ 
MTTAB 


XMDRV 


DRGPP 
PLSUB 
TTDRV 


POWER 
SYSCM 


DRPUT 


SYSCM 


DRDSP 
DRRES 
PPTAB 


XPDRV 


DRMAP 
REQSB 


REQSB 


LOADR 


SYTAB 


DRGTK 
DTTAB 
REQSB 


XQDRV 


DRPUT 
SSTSR 


REQSB 


TTDRV 


Conditional 
Assembly 
Parameter 


R$$K11 
RS$$L11 
RSS$LKL 
RSSM11 
RSSMOF 
R$ $NDC 
RS$$P11 
RSSSND 
R$$X11 
SSSECC 
SSSWPC 
SSSWPR 
SS$YSZ 
T$$18S 
TS$$30P 
TSSA11 
TSSACR 
TSSBTW 
TSSBUF 
TS$Cll 
TSSCCA 
TSSCCO 
TSSCTR 
TSSESC 
TSSGMC 
TS$SGTS 
TSSHLD 
TS$J16 
TSSKMG 


TSSLWC 


CROSS-REFERENCES 


Modules That Contain 
The Parameter 


IOSUB 
DLDRV 
DRQIO 
IOSUB 
IOSUB 
TDSCH 
DPDRV 
DRDSP 
DXDRV 
DBDRV 
LOADR 
LOADR 
SYSCM 
TIDRV 
SYSXT 
CTDRV 
SYSTB 
SYSTB 
DREIF 
DTDRV 
SYSTB 
SYSTB 
TTDRV 
SYSTB 
SYSTB 
SYSTB 
SYSTB 
MMDRV 
DREIF 


TTDRV 


ICSUB 


ICSUB 


IOSUB 


DREIF 


DMDRV 


REQSB 


TT'DRV 


TTDRV 
TIDRV 
DREXP 
IOSUB 
TTDRV 


TTDRV 


TIDRV 
TTDRV 
TIDRV 


TTDRV 


IOSUB 


SYSXT 


DRPUT 


IOSUB 


TDSCH 


DRREG 


TTDRV 
DRRAS LOADR REQSB 
SYSXT TTDRV 


CROSS-REFERENCES 


Conditional 

Assembly Modules That Contain 
Parameter The Parameter 
TSS$M1l MTDRV 

TSSMIN TTDRV 

TSSRNE TTDRV 

TSSRPR SYSTB TTDRV 
TS$RST TTDRV 

TSS$RUB TTDRV 

TSSSMC SYSXT TTDRV 
TSSSYN SYSXT TTDRV 
TSSTRW SYSXT TTDRV 
TSSUTB SYSXT TTDRV 
TSSVBF SYSXT TTDRV 
USSADM BFCTL 

VSS$CTR LOWCR SYSDF 
X$$18 XMDRV 

X$$22 XMDRV 

XSS$LDM XMDRV 

X$$M11-1 XMDRV 

XSSM11 XMDRV 


9.10 MODULE TO CONDITIONAL ASSEMBLY PARAMETER CROSS-REFERENCE 


This cross-reference contains a listing of the Executive modules 


contain 


conditional assembly parameters. 


Module are the parameters that affect the assembly of the module. 


Module 


BFCTL 


CORAL 
CRASH 
CTDRV 


CTTAB 


Conditional Assembly Parameters in Module 


A$SD01 
NSSMOV 


QS$SOPT 
BSSOOT 
ESSDVC 


DSSIAG 
MSSMUP 


ASSF1l1 
PSSWRD 


RSSDER 
CS$SCDA 
TSSA11 


ESSDVC 


GS$S$WRD ISSCAD MSSMGE 
USSADM 

CSSRSH LSSSTI1 MSSMGE 
LSSDRV LDSCT © MSSMGE 


Listed to the right of each 


Module 


DBDRV 


DKTAB 


DLDRV 


DMDRV 


DMTAB 


DPDRV 


DRASG 
DRATX 


DRCIN 


DRDAR 
DRDCP 
DRDRV 
DRDSP 


DREIF 


DREXP 


DRGCL 
DRGLI 
DRGPP 
DRGSS 
DRGTK 
DRGTP 
DRMAP 


DRMKT 


CROSS-REFERENCES 


Conditional Assembly Parameters in Module 


DSSIAG 
MSSMGE 


ASSCPS 
MSSEXT 


DSSTIAG - 


DSSIAG 
RSS60F 


ASSCPS 
MSSEXT 


DSSIAG 
RS$S$P11l 


LSSASG 
ASS$CHK 


ASS$TRP 
MSSMGE 


ASSTRP 


- CSSCKP 


ESSDVC 


ASSCHK 
DSSISK 
GS$TSS 
PSSGMX 


ASSPRI 
DSSYNM 
MSSMGE 
TSSBUF 


ASSTRP 
MSSMGE 


_ MESCRK 


ASSCHK 
ASS$CHK 
G$$TSS 
AS$CHK 
ASS$CHK 
ASSTRP 


MS SMUP 


DSSWCK 
RSSJP1 


DSSIAG 
MSSMUP 


ESSDVC 


DS$WCK 
RS$611 


DSSIAG 
MSSMGE 


DS$WCK 


MSSMUP 
ASS$TRP 


CSSINT 


CSSINT 
MSSEXT 


ASSPRI 
DSSYNM 
GSS$TTK 
PSSLAS 


ASS$TRP 
FSSLPP 
PSSLAS 
TSSKMG 


CSSCKP 
PSSLAS 


LSS$DRV 


DSSYNM- 


GS$STTK 
MS$MGE 


PS $GMX 


ESSDVC 
RSSJPO 


ESSDVC 


MSSEXT 


E$$DVC 
SSSECC 


ESS$DVC 
MSSMUP 


_ ESSDVC 


CSSCKP 
DSSSHF 


DSSISK 
MSSMGE 


ASSTRP 
ESSXPR 
MSSCRX 
PSSRFL 


CSS$CKP 


ISSRAR 
PSSRFL 


DSSYNC 


TSS$BUF 


MSSMGE- 


’ GSSTPP 


MSSMGE 


PSSLAS 


MSSEXT 
SSSECC 


LSSDRV 


MSSMGE 


MSSEXT 


LSSDRV 


MSSEXT 


DSSISK 


DSSYNM 


CSSCKP 
FSSLPP 
MSSMGE 
PSSSRF 
CSSINT 


ISSRDN 
PSSSRF 


DSSYNM 


MSSMGE 


MSSMUP 


PSSSRF 


MSSIXD 
LD$DK 


RSS$L11 


MSSMGE 
LDSDM 


MSSMGE 


MSSMGE 


ESSNSI 


CSSINT 
GSSTPP 
MSSMUP 
RSSSND 


DSSISK 
MSSCRX 
RSSSND 


ESSXPR 


PSSLAS 


R$$11s 


Module 


DRPUT 


DRQIO 


DRRAS 


DRREG 


DRREQ 
DRRES 
DRSED 
DRSST 
DTDRV 


DTTAB 


DXDRV 


DXTAB 


ERROR 
INITL 
IOSUB 


LOADR 


LOWCR 


LPDRV 


LPTAB 


MMDRV 


MMTAB 


MTDRV 


CROSS-REFERENCES 


Conditional Assembly Parameters in Module 


ASSTRP 
RSS$SND 


ASSCHK 
MS$MGE 


ASS$CHK 


ASSTRP 
PSSLAS 


DSSYNM 
ASSCPS 
AS$CHK 
ASSCHK 
DSSIAG 


ASSCPS 
MSSEXT 


ESSDVC 


ASSCPS 
MSS$MGE 


D$$IAG 
L$$SIl 


ASSCHK 
DSSISK 
MSSEXT 
R$$611 
RS$L11 
SSSECC 


ASSTRP 
LSSLDR 
RSSSND 


D$S$H11 
PSSLAS 


L$$11R © 


DSSIAG 
MSSMUP 


DS$IAG 
TS$$J16 


ASSNSI 
LDSMT 


ASSNSI 
TSSM11 


FSSLPP 


ASSCPS 
MSSMUP 


- MSSMGE 


CS$CKP 
TSSBUF 


MSSMGE 
ASS$PRI 
M$ $MGE 
M$ $MGE 
ES$DVC 


DSSIAG 
MS$MGE 


MSS$MGE 


DSSIAG 
MSSMUP 


ES$DVC 
MSSEXT 


ASSCPS 
DSSSHF 
MSSIXD 
RSSJPO 
RSS$M11 
TSSKMG 


CSSCKP 
MSSMGE 
SSSWPC 


ESSNSI 
VSSCTR 


LS$$P1ll1 
ESSDVC 


ESSDVC 


DSSIAG 
MSSMGE 


DSSIAG 


PSSLAS 


ASSNSI 
MSSNET 
MSSMUP 


DS$ISK 


M$ $MUP 


DSSISK 


 MSSEXT 
ES$DVC 


MS SMUP 
RSS$X1l 
ESSDVC 


ESSNSI 


MSSMGE_. 
ASSTRP_ 


DSSYNM 


MSS$MGE 
RS$JS1°- 
R$$P1l1- 


DSSISK 
PSSLAS 
SSSWPR 


I$scll 


PSSRFL 


DSSIAG 
RSSLKL 


RS$SND - 


DSSYNM 


MSSMUP 


MS$SMGE 


LS$$DRV 


LSSDRV 


" BSSPER 


PSS$RTY 


“CS$CKP 


ESSDVC 


QS$SOPT 


RSS$C1l 
RSSLKL 


DSSYNC 
PSSSRF 


MSSNGE 


MSSMGE. ~~ 2: 


LSSDRV 


MSSEXT 


ESSDVC 
MSSMUP 


ES$DVC 


LDSLP 


MSSIXD 


- L$SDRV 


MSSEXT 


PSSSRF 


L$SDRV 


- MS$MGE 


, TE$CL1 


‘LDS DT 
LD$DX 


R$$11s8 


DSS$IAG 
LSSDRV 
RSS60F 
RSS$K11 
RSSMOF 


ESSXPR 
R$$115S 


MSSNET 


MSSMGE 
MSSMGE 
LDSMM 


MSSMGE 


Module 


MTTAB 


NULTK 
PARTY 
PLSUB 
POWER 


PPTAB 


PRDRV 
QUEUE 
REQSB 


SSTSR 


SYSCM 


SYSDF 


SYSTB 


SYSXT 


SYTAB 


TDSCH 


CROSS-REFERENCES 


Conditional Assembly Parameters in Module 


ASSNSI 


MSSEXT 


PS$P45 - 
/ -DS$SHF- 
DS$YNM 


~ ASSTRP - 


FSSAST 
MSSEXT 


DSSIAG 


MSSMGE 
PS$R11 


LSSDRV 


ASSTRP 
DSSYNC 
MSSMUP 
SSSWPC 


ASSCHK 
PSSLAS 


CS$SCKP 
ESSXPR 
LSSLDR 
NSSUMR 
RSSEXV 


DSSYNM 


DSSIAG 
MSSMGE 
TSS$CCO 
TSSRPR 


ASSTRP 
ESSEAE 


MSSMGE 


TSSSMC 
TSSVBF 


LSSLDR 


ASSTRP 
KSS$W1l 


DSSIAG 
MSSMGE 


_ ESSPER 
MSSMGE 
ESSDVC | 


FSSLPP 
MSSMGE 


ESSDVC 
MSSMUP 


MS$MGE 


“C$SCKP 


DSSYNM 


‘. P§$LAS 


FSSAST | 


DSSYNC 
KSSCNT 


L$$SIl 


PS$S$LAS 
SSSYSZ 


MSSEXT 


ESSDVC 
MSSMUP 
TSSESC 


CSSCKP 
ESSNSI 
PS$SLAS 
TSSSYN 


MSS MGE 


CS$CKP 
LSSDRV 


ESSDVC 
M$$MUP 


MSSMGE 
PSSLAS 
ESSEAE 


KSSWll 
PSSRFL 


LSS$DRV 


- CS$SINT: | 
FSSLPP > 


P$$RFL 
FSSLPP 


DSSYNM 
KSSCSR 
MSSEXT 
PSSRTY 


MS$MGE 


LSSDRV 
TSSACR 
TSSGMC 


CSSINT 
FSSLPP 
RSSEXV 
TSSTRW 


PSSLAS 


DSSISK 
MSSMGE 


LSSDRV 


P$$D70 


ESSNSI 
LSSDRV 
PSSRTY 


LDS PP 


DSSISK 
LSSDRV 
PSSSRF 


FSSLTP 


ESSDVC 
KSSLDC 
MSSMGE 
QSSOPT 


VSSCTR 


LDSNL 
TSSBTW 
TS$GTS 


DSSYNM 
LSSDRV 
RSSLKL 
TSSUTB 


PSSSRF 


DSSSHF 
RSSNDC 


LDSMT 


PSSRTY 


ESSPER 
L$$SI1 


LDSPR 


DSSSHF 
MSSMGE 
RSSSND 


MSSMGE 


ESSNSI 
LSSDRV 
MSSMUP 
R$$11S 


LDSTT 
TSSCCA 
TSSHLD 


ESSDVC 
LSSSI1 
TSSBUF 
TSS30P 


RSS1ls 


DSSYNM 
SSSWPC 


Module 


TTDRV 


XBDRV 


XMDRV 


XPDRV 


XQDRV > 


XUDRV 


XWDRV 


CROSS-REFERENCES 


Conditional Assembly Parameters in Module 


ASSCHK 
DSSL11 
ISSRAR 
LDSS$H 

MSSCRI 
RSSLKL 


TSSBUF . 


TSSGMC 
TSSRNE 
TSSSYN 


D$$B1l1 


LDSXM 
Q$$Io 


X$$M11-1 


M$ $MGE 


D$$Qli-1 


QS$S$CRC* 


CSSMPT 


ASSTRP 
DSS$M11 
IS$SRDN 
LDSSJ 

MSSMGE 
T$$18Ss 
TSS$CCA 
TS$GTS 
TSSRPR 
TSSTRW 


MSSEXT | 


MSSEXT 
X$$18 


MSS$NET 
D$$Qll 


CSSCKP 
DSSYNM 
L$$508 
LDSSL 

MSSMUP 
T$S30P 
TSSCCO 


TSSHLD =" 


TSSRST 


fon 


TSSUTB" 


MS$MGE 


’ MS$MGE 


X$$22 


D§$Pl1-1 


__MS$SEXT 
QSSHPT -** ae 


CS$MPT  DS$$U11-1¢b$su11 


DS$W11-1 D$$wl1l 


D$$Hll ° 
D$$z11 


L$$DRV 
LDS$Z - 
PSSLAS 


TSSACR . 


TSSCTR 
TS$RUB 


TSSVBF. : 
MSSNET 

Brerre 
DS$P11 
MSSMGE_ 


MSSMGE 
_MS$MGE 


“TSSLWC 


wr 


- MSSNET*.— 
XSSLDM 


2 m® é 


D$$J1l 
D$$ ZMD 
L$$SI1 


"EDSTT 


R$$11S 


‘TS$SBTW 


TSSESC 


“TSSMIN 


TSS$SMC 


MSSNET 


-MSSNET 
_MSSNET 


